@wowok/agent-mcp 2.7.1 → 2.7.2
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/index.js +1 -1
- package/dist/config/runtime.js +1 -238
- package/dist/customer/customer-advice.js +1 -130
- package/dist/customer/index.js +1 -11
- package/dist/customer/industry-risks.js +1 -438
- package/dist/customer/info-puzzle.js +1 -681
- package/dist/customer/order-monitor.js +1 -328
- package/dist/customer/order-strategy.js +1 -373
- package/dist/customer/post-purchase.js +1 -351
- package/dist/customer/preorder-compare.js +1 -34
- package/dist/customer/reminder-system.js +1 -316
- package/dist/customer/risk-assessment.js +1 -397
- package/dist/customer/types.js +1 -13
- package/dist/customer/user-preferences.js +1 -460
- package/dist/evaluation/arbitration-game.d.ts +9 -2
- package/dist/evaluation/arbitration-game.js +1 -48
- package/dist/evaluation/builtins/demand-match.js +1 -153
- package/dist/evaluation/builtins/index.js +1 -10
- package/dist/evaluation/builtins/service-risk.js +1 -55
- package/dist/evaluation/capability.js +1 -13
- package/dist/evaluation/composer.js +1 -40
- package/dist/evaluation/engine.js +1 -175
- package/dist/evaluation/extract.js +1 -115
- package/dist/evaluation/game-strategy.d.ts +27 -0
- package/dist/evaluation/game-strategy.js +1 -0
- package/dist/evaluation/gap.js +1 -100
- package/dist/evaluation/index.d.ts +1 -0
- package/dist/evaluation/index.js +1 -11
- package/dist/evaluation/node-game.d.ts +31 -3
- package/dist/evaluation/node-game.js +1 -57
- package/dist/evaluation/region.js +1 -36
- package/dist/evaluation/types.d.ts +1 -0
- package/dist/evaluation/types.js +1 -1
- package/dist/evaluation/user-injection.js +1 -27
- package/dist/experience/experience-reuse.js +1 -103
- package/dist/experience/index.js +1 -5
- package/dist/experience/intent-distill.js +1 -83
- package/dist/experience/realtime-feedback.js +1 -94
- package/dist/experience/types.js +1 -1
- package/dist/experience/user-profile.js +1 -171
- package/dist/extensions/business-modules.js +1 -287
- package/dist/extensions/capability-manifest.js +1 -781
- package/dist/extensions/constraint-registry.js +1 -198
- package/dist/extensions/index.js +1 -6
- package/dist/extensions/metric-registry.js +1 -257
- package/dist/extensions/mode-evaluator.js +1 -170
- package/dist/extensions/modes.js +1 -499
- package/dist/extensions/registry.js +1 -717
- package/dist/extensions/types.js +1 -1
- package/dist/harness/auto-escalation.js +1 -68
- package/dist/harness/checkpoint.js +1 -129
- package/dist/harness/index.js +1 -78
- package/dist/harness/plan.js +1 -315
- package/dist/harness/recover.js +1 -139
- package/dist/harness/types.js +1 -1
- package/dist/harness/verify.js +1 -237
- package/dist/index.js +1 -273
- package/dist/intent/enrich.js +1 -67
- package/dist/intent/index.js +1 -60
- package/dist/intent/matcher.js +1 -81
- package/dist/intent/store.js +1 -55
- package/dist/intent/types.js +1 -10
- package/dist/knowledge/acquisition-flywheel.js +1 -192
- package/dist/knowledge/allocation-confirm.js +1 -534
- package/dist/knowledge/allocation-context.js +1 -249
- package/dist/knowledge/allocation-ledger.js +1 -463
- package/dist/knowledge/allocation-puzzle.js +1 -298
- package/dist/knowledge/allocation-risk.js +1 -568
- package/dist/knowledge/allocation-templates.js +1 -970
- package/dist/knowledge/allocation-translation.js +1 -585
- package/dist/knowledge/arb-risk.js +1 -210
- package/dist/knowledge/arbitration-confirm.js +1 -559
- package/dist/knowledge/arbitration-context.js +1 -505
- package/dist/knowledge/arbitration-ledger.js +1 -521
- package/dist/knowledge/arbitration-puzzle.js +1 -304
- package/dist/knowledge/arbitration-risk.js +1 -423
- package/dist/knowledge/arbitration-templates.js +1 -276
- package/dist/knowledge/arbitration-translation.js +1 -487
- package/dist/knowledge/arbitration-trust.js +1 -117
- package/dist/knowledge/audit-rules.js +1 -141
- package/dist/knowledge/bridge-risk.js +1 -263
- package/dist/knowledge/contact-risk.js +1 -200
- package/dist/knowledge/contact-templates.js +1 -60
- package/dist/knowledge/demand-confirm.js +1 -206
- package/dist/knowledge/demand-matching.js +1 -132
- package/dist/knowledge/demand-risk.js +1 -240
- package/dist/knowledge/demand-translation.js +1 -354
- package/dist/knowledge/deployment-scanner.js +1 -823
- package/dist/knowledge/dynamic-pricing.js +1 -87
- package/dist/knowledge/examples-scanner-cli.js +1 -26
- package/dist/knowledge/examples-scanner.js +1 -843
- package/dist/knowledge/flywheel-loop.js +1 -404
- package/dist/knowledge/fund-layer.js +1 -973
- package/dist/knowledge/glossary.js +1 -211
- package/dist/knowledge/guard-confirm.js +1 -406
- package/dist/knowledge/guard-context.js +1 -287
- package/dist/knowledge/guard-design-patterns.js +1 -360
- package/dist/knowledge/guard-ledger.js +1 -260
- package/dist/knowledge/guard-lint.js +1 -670
- package/dist/knowledge/guard-migration.js +1 -228
- package/dist/knowledge/guard-puzzle.js +1 -805
- package/dist/knowledge/guard-render.js +1 -700
- package/dist/knowledge/guard-risk.js +1 -1879
- package/dist/knowledge/guard-submission-prompt.js +1 -171
- package/dist/knowledge/guard-templates.js +1 -1105
- package/dist/knowledge/guard-translation.js +1 -1119
- package/dist/knowledge/index.js +1 -436
- package/dist/knowledge/industry-evolution.js +1 -323
- package/dist/knowledge/industry-generalizer.js +1 -381
- package/dist/knowledge/industry-registry.js +1 -174
- package/dist/knowledge/intent-metrics.d.ts +4 -3
- package/dist/knowledge/intent-metrics.js +1 -566
- package/dist/knowledge/machine-confirm.js +1 -559
- package/dist/knowledge/machine-context.js +1 -833
- package/dist/knowledge/machine-ledger.js +1 -338
- package/dist/knowledge/machine-puzzle.js +1 -494
- package/dist/knowledge/machine-render.js +1 -565
- package/dist/knowledge/machine-risk.js +1 -669
- package/dist/knowledge/machine-templates.js +1 -1597
- package/dist/knowledge/machine-topology.js +1 -234
- package/dist/knowledge/machine-translation.js +1 -513
- package/dist/knowledge/mcp-schema-audit-cli.js +1 -45
- package/dist/knowledge/mcp-schema-audit.js +1 -777
- package/dist/knowledge/onchain-constants.js +1 -35
- package/dist/knowledge/order-confirm.js +1 -573
- package/dist/knowledge/order-context.js +1 -390
- package/dist/knowledge/order-ledger.js +1 -341
- package/dist/knowledge/order-puzzle.js +1 -255
- package/dist/knowledge/order-risk.js +1 -653
- package/dist/knowledge/order-templates.js +1 -368
- package/dist/knowledge/order-translation.js +1 -550
- package/dist/knowledge/overrides-loader.js +1 -65
- package/dist/knowledge/passport-confirm.js +1 -531
- package/dist/knowledge/passport-context.js +1 -306
- package/dist/knowledge/passport-ledger.js +1 -282
- package/dist/knowledge/passport-puzzle.js +1 -333
- package/dist/knowledge/passport-risk.js +1 -450
- package/dist/knowledge/passport-templates.js +1 -568
- package/dist/knowledge/passport-translation.js +1 -516
- package/dist/knowledge/payment-risk.js +1 -249
- package/dist/knowledge/permission-confirm.js +1 -426
- package/dist/knowledge/permission-context.js +1 -224
- package/dist/knowledge/permission-ledger.js +1 -403
- package/dist/knowledge/permission-puzzle.js +1 -173
- package/dist/knowledge/permission-risk.js +1 -411
- package/dist/knowledge/permission-templates.js +1 -234
- package/dist/knowledge/permission-translation.js +1 -350
- package/dist/knowledge/personal-risk.js +1 -212
- package/dist/knowledge/process-model.js +1 -160
- package/dist/knowledge/progress-confirm.js +1 -456
- package/dist/knowledge/progress-context.js +1 -452
- package/dist/knowledge/progress-ledger.js +1 -330
- package/dist/knowledge/progress-puzzle.js +1 -219
- package/dist/knowledge/progress-risk.js +1 -461
- package/dist/knowledge/progress-templates.js +1 -228
- package/dist/knowledge/progress-translation.js +1 -405
- package/dist/knowledge/proof-confirm.js +1 -187
- package/dist/knowledge/proof-risk.js +1 -207
- package/dist/knowledge/proof-translation.js +1 -283
- package/dist/knowledge/registrar-risk.js +1 -217
- package/dist/knowledge/repository-confirm.js +1 -286
- package/dist/knowledge/repository-risk.js +1 -373
- package/dist/knowledge/repository-translation.js +1 -445
- package/dist/knowledge/reputation-rules.js +1 -99
- package/dist/knowledge/resource-risk.js +1 -157
- package/dist/knowledge/reward-confirm.js +1 -526
- package/dist/knowledge/reward-context.js +1 -504
- package/dist/knowledge/reward-ledger.js +1 -502
- package/dist/knowledge/reward-puzzle.js +1 -300
- package/dist/knowledge/reward-risk.js +1 -627
- package/dist/knowledge/reward-templates.js +1 -197
- package/dist/knowledge/reward-translation.js +1 -501
- package/dist/knowledge/safety-rules.js +1 -404
- package/dist/knowledge/scenario-modes.js +1 -321
- package/dist/knowledge/service-confirm.js +1 -807
- package/dist/knowledge/service-context.js +1 -403
- package/dist/knowledge/service-ledger.js +1 -609
- package/dist/knowledge/service-puzzle.js +1 -236
- package/dist/knowledge/service-risk.js +1 -651
- package/dist/knowledge/service-templates.js +1 -456
- package/dist/knowledge/service-translation.js +1 -622
- package/dist/knowledge/template-registry.js +1 -353
- package/dist/knowledge/tool-constraints.js +1 -195
- package/dist/knowledge/tools-reference.js +1 -178
- package/dist/knowledge/treasury-confirm.js +1 -512
- package/dist/knowledge/treasury-context.js +1 -363
- package/dist/knowledge/treasury-ledger.js +1 -300
- package/dist/knowledge/treasury-puzzle.js +1 -216
- package/dist/knowledge/treasury-risk.js +1 -440
- package/dist/knowledge/treasury-templates.js +1 -358
- package/dist/knowledge/treasury-translation.js +1 -498
- package/dist/knowledge/trust-metrics.js +1 -198
- package/dist/knowledge/util-risk.js +1 -135
- package/dist/loop-engineering/aggregate.js +1 -132
- package/dist/loop-engineering/context-collect.js +1 -83
- package/dist/loop-engineering/diagnose.js +1 -273
- package/dist/loop-engineering/improve.js +1 -405
- package/dist/loop-engineering/index.js +1 -4
- package/dist/loop-engineering/pipeline.js +1 -56
- package/dist/mode-market/index.js +1 -3
- package/dist/mode-market/registry.js +1 -124
- package/dist/mode-market/review.js +1 -214
- package/dist/mode-market/submission.js +1 -85
- package/dist/participation/collaborator-interest.d.ts +23 -0
- package/dist/participation/collaborator-interest.js +1 -0
- package/dist/participation/customer-interest.d.ts +25 -0
- package/dist/participation/customer-interest.js +1 -0
- package/dist/participation/merchant-interest.js +1 -100
- package/dist/participation/radar-core.d.ts +13 -3
- package/dist/participation/radar-core.js +1 -269
- package/dist/participation/supplier-interest.d.ts +25 -0
- package/dist/participation/supplier-interest.js +1 -0
- package/dist/persona/analyzer.js +1 -66
- package/dist/persona/bridge.js +1 -86
- package/dist/persona/defaults.js +1 -195
- package/dist/persona/experience-bridge.js +1 -23
- package/dist/persona/index.js +1 -71
- package/dist/persona/model.js +1 -111
- package/dist/persona/store.js +1 -62
- package/dist/persona/types.d.ts +3 -1
- package/dist/persona/types.js +1 -5
- package/dist/project/business-puzzle.js +1 -383
- package/dist/project/context-assembly.js +1 -254
- package/dist/project/deployment-bridge.js +1 -120
- package/dist/project/deployment-doc.js +1 -1126
- package/dist/project/edit-planner.js +1 -1342
- package/dist/project/evaluation.js +1 -2011
- package/dist/project/game-theory.js +1 -177
- package/dist/project/graph-builder.js +1 -656
- package/dist/project/graph.js +1 -340
- package/dist/project/handlers.js +1 -1784
- package/dist/project/index.d.ts +1 -0
- package/dist/project/index.js +1 -301
- package/dist/project/intent-analyzer.js +1 -149
- package/dist/project/machine-nodes.js +1 -36
- package/dist/project/merchant-guide.js +1 -264
- package/dist/project/migration.js +1 -125
- package/dist/project/mode-actions.js +1 -309
- package/dist/project/namespace.js +1 -206
- package/dist/project/participation-radar.js +1 -428
- package/dist/project/pipeline-actions.js +1 -109
- package/dist/project/project-store.js +1 -422
- package/dist/project/query.js +1 -153
- package/dist/project/reverse-mapping.d.ts +34 -0
- package/dist/project/reverse-mapping.js +1 -0
- package/dist/project/risk-aggregator.js +1 -295
- package/dist/project/rollback-policy.js +1 -290
- package/dist/project/semantic-assembler.js +1 -345
- package/dist/project/semantic-graph.js +1 -292
- package/dist/project/stage-gate.js +1 -369
- package/dist/project/substep-trace.js +1 -332
- package/dist/project/task-tracker.js +1 -78
- package/dist/role/derivation.d.ts +18 -0
- package/dist/role/derivation.js +1 -0
- package/dist/role/index.d.ts +5 -0
- package/dist/role/index.js +1 -0
- package/dist/role/model.d.ts +8 -0
- package/dist/role/model.js +1 -0
- package/dist/role/resolution.d.ts +11 -0
- package/dist/role/resolution.js +1 -0
- package/dist/role/types.d.ts +11 -0
- package/dist/role/types.js +1 -0
- package/dist/rules.js +1 -52
- package/dist/safety/confirm-gate.js +1 -88
- package/dist/safety/index.js +1 -3
- package/dist/safety/preview.js +1 -52
- package/dist/schema/call/allocation.js +1 -34
- package/dist/schema/call/arbitration.js +1 -113
- package/dist/schema/call/base.d.ts +15 -15
- package/dist/schema/call/base.js +1 -370
- package/dist/schema/call/bridge-handler.js +1 -265
- package/dist/schema/call/bridge.d.ts +7 -7
- package/dist/schema/call/bridge.js +1 -458
- package/dist/schema/call/contact.js +1 -37
- package/dist/schema/call/demand.js +1 -47
- package/dist/schema/call/guard.js +1 -161
- package/dist/schema/call/handler.js +1 -322
- package/dist/schema/call/index.js +1 -20
- package/dist/schema/call/machine.js +1 -193
- package/dist/schema/call/order.js +1 -35
- package/dist/schema/call/payment.js +1 -37
- package/dist/schema/call/permission-handler.js +1 -54
- package/dist/schema/call/permission.js +1 -105
- package/dist/schema/call/personal.js +1 -78
- package/dist/schema/call/progress.js +1 -47
- package/dist/schema/call/proof.js +1 -33
- package/dist/schema/call/repository.js +1 -77
- package/dist/schema/call/reward.js +1 -30
- package/dist/schema/call/semantic.js +1 -1679
- package/dist/schema/call/service.js +1 -184
- package/dist/schema/call/treasury.js +1 -71
- package/dist/schema/common/index.js +1 -407
- package/dist/schema/config/index.js +1 -68
- package/dist/schema/evaluation/index.d.ts +213 -16
- package/dist/schema/evaluation/index.js +1 -356
- package/dist/schema/index.js +1 -17
- package/dist/schema/intent-radar/index.d.ts +13 -13
- package/dist/schema/intent-radar/index.js +1 -89
- package/dist/schema/local/index.d.ts +21 -21
- package/dist/schema/local/index.js +1 -927
- package/dist/schema/local/wip.js +1 -187
- package/dist/schema/messenger/index.d.ts +7 -7
- package/dist/schema/messenger/index.js +1 -475
- package/dist/schema/operations.d.ts +7 -7
- package/dist/schema/operations.js +1 -520
- package/dist/schema/persona/index.d.ts +54 -54
- package/dist/schema/persona/index.js +1 -148
- package/dist/schema/project/index.d.ts +94 -48
- package/dist/schema/project/index.js +1 -2057
- package/dist/schema/query/index.d.ts +423 -7
- package/dist/schema/query/index.js +1 -1646
- package/dist/schema/schema-query/index.js +1 -104
- package/dist/schema/schema-version.js +1 -76
- package/dist/schema/sync-layer4.js +1 -286
- package/dist/schema/task-status.js +1 -36
- package/dist/schema/trust/index.js +1 -314
- package/dist/schema/utils/guard-parser.js +1 -419
- package/dist/schema/utils/guard-query-utils.js +1 -46
- package/dist/schema/utils/node-parser.js +1 -369
- package/dist/schema/utils/object-type-utils.js +1 -35
- package/dist/schema/utils/permission-index-utils.js +1 -7
- package/dist/schema/utils/permission-machine-check.js +1 -121
- package/dist/schema/utils/skills-recommendation.js +1 -77
- package/dist/schema-query/index.js +1 -810
- package/dist/schemas/account_operation.output.json +5 -2
- package/dist/schemas/bridge_operation.output.json +5 -2
- package/dist/schemas/evaluation_operation.output.json +112 -7
- package/dist/schemas/evaluation_operation.schema.json +93 -6
- package/dist/schemas/index.json +1 -1
- package/dist/schemas/intent_radar.output.json +4 -1
- package/dist/schemas/intent_radar.schema.json +4 -1
- package/dist/schemas/local_info_operation.output.json +5 -2
- package/dist/schemas/local_mark_operation.output.json +5 -2
- package/dist/schemas/messenger_operation.output.json +5 -2
- package/dist/schemas/onchain_events.output.json +5 -2
- package/dist/schemas/onchain_operations.output.json +5 -2
- package/dist/schemas/onchain_operations.schema.json +4 -4
- package/dist/schemas/onchain_operations_allocation.schema.json +1 -1
- package/dist/schemas/onchain_operations_machine.schema.json +2 -2
- package/dist/schemas/onchain_operations_service.schema.json +1 -1
- package/dist/schemas/onchain_table_data.output.json +6 -3
- package/dist/schemas/persona_operation.output.json +4 -1
- package/dist/schemas/persona_operation.schema.json +4 -1
- package/dist/schemas/project_operation.output.json +28 -8
- package/dist/schemas/query_toolkit.output.json +8 -5
- package/dist/schemas/wowok_buildin_info.output.json +132 -0
- package/dist/schemas/wowok_buildin_info.schema.json +14 -0
- package/dist/telemetry/index.js +1 -112
- package/dist/telemetry/redact.js +1 -23
- package/dist/telemetry/storage.js +1 -80
- package/dist/tools/handlers/bridge.js +1 -1
- package/dist/tools/handlers/config.js +1 -74
- package/dist/tools/handlers/evaluation.js +1 -123
- package/dist/tools/handlers/file-export.js +1 -90
- package/dist/tools/handlers/intent-radar.js +1 -76
- package/dist/tools/handlers/local.js +1 -53
- package/dist/tools/handlers/messenger.js +1 -188
- package/dist/tools/handlers/onchain.js +1 -1180
- package/dist/tools/handlers/persona.js +1 -89
- package/dist/tools/handlers/project.js +1 -211
- package/dist/tools/handlers/query.js +1 -434
- package/dist/tools/handlers/schema-query.js +1 -176
- package/dist/tools/handlers/task-status.js +1 -26
- package/dist/tools/handlers/trust.js +1 -380
- package/dist/tools/handlers/wip.js +1 -90
- package/dist/tools/index.js +1 -1382
- package/dist/tools/retry.js +1 -85
- package/dist/tools/rules-hook.js +1 -23
- package/dist/tools/shared.js +1 -130
- package/dist/tools/types.js +1 -1
- package/dist/tools/upgrade-check.d.ts +19 -0
- package/dist/tools/upgrade-check.js +1 -0
- package/dist/tools/wip-deploy-assist.js +1 -306
- package/dist/tools/wrap.js +1 -500
- package/package.json +4 -2
|
@@ -1,450 +1 @@
|
|
|
1
|
-
import { MAX_GUARD_COUNT_PASSPORT, MAX_SUBMISSION_SIZE_PASSPORT, PASSPORT_ERROR_CODES, } from "./passport-ledger.js";
|
|
2
|
-
const R_P_1_01 = {
|
|
3
|
-
id: "R-PASS-01",
|
|
4
|
-
category: "lifecycle",
|
|
5
|
-
trigger: "tx_hash binding — Passport cannot be reused across transactions",
|
|
6
|
-
check: (ctx) => {
|
|
7
|
-
if (ctx.operation_type !== "create" && ctx.operation_type !== "use")
|
|
8
|
-
return null;
|
|
9
|
-
return {
|
|
10
|
-
id: "R-PASS-01",
|
|
11
|
-
level: "HIGH",
|
|
12
|
-
category: "lifecycle",
|
|
13
|
-
title: "tx_hash binding — Passport cannot be reused across transactions",
|
|
14
|
-
description: "Passport is bound to tx_context::digest(ctx) at creation time. All write functions (guard_add / guard_clear / verify) and result queries require tx_hash to match the current transaction, otherwise abort E_DIGEST_NOT_MATCH (11) or E_TX_NOT_MATCH (8). Caller must complete all operations within the same transaction (new → guard_add → verify → result → consume).",
|
|
15
|
-
affected_stakeholders: ["creator", "consumer"],
|
|
16
|
-
scenario: "Caller attempts to use Passport created in a previous transaction",
|
|
17
|
-
mitigation: "SDK encapsulates single-transaction flow (verify_guard: new → guard_add → verify → freeze). To reuse across transactions, you must recreate the Passport and resubmit all Guard data.",
|
|
18
|
-
evidence: "tx_hash field set at new() time, enforced in guard_add/verify/result",
|
|
19
|
-
related_move_error: "E_DIGEST_NOT_MATCH (11), E_TX_NOT_MATCH (8)",
|
|
20
|
-
auto_fixable: false,
|
|
21
|
-
};
|
|
22
|
-
},
|
|
23
|
-
};
|
|
24
|
-
const R_P_1_02 = {
|
|
25
|
-
id: "R-PASS-02",
|
|
26
|
-
category: "lifecycle",
|
|
27
|
-
trigger: "has_verified one-time — Guard config cannot be modified after verify",
|
|
28
|
-
check: (ctx) => {
|
|
29
|
-
if (!ctx.has_verified)
|
|
30
|
-
return null;
|
|
31
|
-
if (ctx.operation_type !== "guard_add" && ctx.operation_type !== "guard_clear")
|
|
32
|
-
return null;
|
|
33
|
-
return {
|
|
34
|
-
id: "R-PASS-02",
|
|
35
|
-
level: "MEDIUM",
|
|
36
|
-
category: "lifecycle",
|
|
37
|
-
title: "has_verified one-time — Guard config cannot be modified after verify",
|
|
38
|
-
description: "After Passport.has_verified=true, guard_add / guard_clear / verify all abort E_HAS_VERIFIED (4). verify is a one-time operation and its result is tamper-proof. This is Passport's core security guarantee (anti-tampering), but also means all Guards must be fully configured before verify.",
|
|
39
|
-
affected_stakeholders: ["creator"],
|
|
40
|
-
scenario: "Caller attempts to modify Guard configuration after verify()",
|
|
41
|
-
mitigation: "Fully plan all Guards (impack + non-impack + relies dependencies) before verify(). To modify after verify, create a new Passport.",
|
|
42
|
-
evidence: `has_verified=${ctx.has_verified}, operation=${ctx.operation_type}`,
|
|
43
|
-
related_move_error: "E_HAS_VERIFIED (4)",
|
|
44
|
-
auto_fixable: false,
|
|
45
|
-
};
|
|
46
|
-
},
|
|
47
|
-
};
|
|
48
|
-
const R_P_1_03 = {
|
|
49
|
-
id: "R-PASS-03",
|
|
50
|
-
category: "structural",
|
|
51
|
-
trigger: "No impack Guard — verify will fail E_IMPACK_GUARD_NOT_FOUND",
|
|
52
|
-
check: (ctx) => {
|
|
53
|
-
if (ctx.operation_type !== "verify")
|
|
54
|
-
return null;
|
|
55
|
-
if (ctx.has_impack_guard)
|
|
56
|
-
return null;
|
|
57
|
-
return {
|
|
58
|
-
id: "R-PASS-03",
|
|
59
|
-
level: "MEDIUM",
|
|
60
|
-
category: "structural",
|
|
61
|
-
title: "No impack Guard — verify will fail E_IMPACK_GUARD_NOT_FOUND",
|
|
62
|
-
description: "verify() requires at least 1 impack=true Guard. If all Guards are impack=false, verify aborts E_IMPACK_GUARD_NOT_FOUND (9). Guards with impack=false only record per-Guard result and do not affect the final result.",
|
|
63
|
-
affected_stakeholders: ["creator"],
|
|
64
|
-
scenario: "Passport configured with only non-impack Guards",
|
|
65
|
-
mitigation: "Configure at least 1 Guard as impack=true. Failure of this Guard immediately sets the overall result=false.",
|
|
66
|
-
evidence: `has_impack_guard=${ctx.has_impack_guard ?? false}`,
|
|
67
|
-
related_move_error: "E_IMPACK_GUARD_NOT_FOUND (9)",
|
|
68
|
-
auto_fixable: true,
|
|
69
|
-
};
|
|
70
|
-
},
|
|
71
|
-
};
|
|
72
|
-
const R_P_2_01 = {
|
|
73
|
-
id: "R-PASS-04",
|
|
74
|
-
category: "logic",
|
|
75
|
-
trigger: "Depended Guard order error — E_RELIES_GUARD_NOT_ADDED",
|
|
76
|
-
check: (ctx) => {
|
|
77
|
-
if (ctx.operation_type !== "guard_add")
|
|
78
|
-
return null;
|
|
79
|
-
if (!ctx.relies_map)
|
|
80
|
-
return null;
|
|
81
|
-
const added = new Set(ctx.guard_config?.guard.map(g => g.object) ?? []);
|
|
82
|
-
for (const [guard, relies] of Object.entries(ctx.relies_map)) {
|
|
83
|
-
if (!added.has(guard))
|
|
84
|
-
continue;
|
|
85
|
-
for (const rely of relies) {
|
|
86
|
-
if (!added.has(rely)) {
|
|
87
|
-
return {
|
|
88
|
-
id: "R-PASS-04",
|
|
89
|
-
level: "HIGH",
|
|
90
|
-
category: "logic",
|
|
91
|
-
title: "Depended Guard order error — E_RELIES_GUARD_NOT_ADDED",
|
|
92
|
-
description: `Guard ${guard} depends on Guard ${rely}, but ${rely} has not been added to Passport yet. guard_add checks dependencies in topological order; if a depended Guard was not added first, abort E_RELIES_GUARD_NOT_ADDED (2).`,
|
|
93
|
-
affected_stakeholders: ["creator"],
|
|
94
|
-
scenario: "Adding a Guard with relies before adding the relied Guard",
|
|
95
|
-
mitigation: `Add the depended Guard ${rely} first, then ${guard}. Dependencies are returned by guard::relies(guard).`,
|
|
96
|
-
evidence: `guard=${guard}, missing_rely=${rely}`,
|
|
97
|
-
related_move_error: "E_RELIES_GUARD_NOT_ADDED (2)",
|
|
98
|
-
auto_fixable: false,
|
|
99
|
-
};
|
|
100
|
-
}
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
return null;
|
|
104
|
-
},
|
|
105
|
-
};
|
|
106
|
-
const R_P_2_02 = {
|
|
107
|
-
id: "R-PASS-05",
|
|
108
|
-
category: "structural",
|
|
109
|
-
trigger: "submission serialized exceeds 256 bytes — E_SUBMISSION_SIZE_EXCEEDED",
|
|
110
|
-
check: (ctx) => {
|
|
111
|
-
if (ctx.max_submission_size === undefined)
|
|
112
|
-
return null;
|
|
113
|
-
if (ctx.max_submission_size <= MAX_SUBMISSION_SIZE_PASSPORT)
|
|
114
|
-
return null;
|
|
115
|
-
return {
|
|
116
|
-
id: "R-PASS-05",
|
|
117
|
-
level: "MEDIUM",
|
|
118
|
-
category: "structural",
|
|
119
|
-
title: `submission serialized exceeds ${MAX_SUBMISSION_SIZE_PASSPORT} bytes — E_SUBMISSION_SIZE_EXCEEDED`,
|
|
120
|
-
description: `Single submission serialized size is ${ctx.max_submission_size} bytes > MAX_SUBMISSION_SIZE_PASSPORT=${MAX_SUBMISSION_SIZE_PASSPORT}. verify() checks BCS serialized size of each submission; if exceeded, abort E_SUBMISSION_SIZE_EXCEEDED (3).`,
|
|
121
|
-
affected_stakeholders: ["creator"],
|
|
122
|
-
scenario: "Submission value too large (e.g. long string or nested struct)",
|
|
123
|
-
mitigation: `Trim submission data to <= ${MAX_SUBMISSION_SIZE_PASSPORT} bytes. For large objects, use Repository references instead of inline data.`,
|
|
124
|
-
evidence: `max_submission_size=${ctx.max_submission_size}, limit=${MAX_SUBMISSION_SIZE_PASSPORT}`,
|
|
125
|
-
related_move_error: "E_SUBMISSION_SIZE_EXCEEDED (3)",
|
|
126
|
-
auto_fixable: false,
|
|
127
|
-
};
|
|
128
|
-
},
|
|
129
|
-
};
|
|
130
|
-
const R_P_2_03 = {
|
|
131
|
-
id: "R-PASS-06",
|
|
132
|
-
category: "structural",
|
|
133
|
-
trigger: "Guard count reaches 20 limit — E_GUARD_COUNT_EXCEEDED",
|
|
134
|
-
check: (ctx) => {
|
|
135
|
-
if (ctx.guard_count === undefined)
|
|
136
|
-
return null;
|
|
137
|
-
if (ctx.guard_count < MAX_GUARD_COUNT_PASSPORT)
|
|
138
|
-
return null;
|
|
139
|
-
return {
|
|
140
|
-
id: "R-PASS-06",
|
|
141
|
-
level: "LOW",
|
|
142
|
-
category: "structural",
|
|
143
|
-
title: `Guard count reaches ${MAX_GUARD_COUNT_PASSPORT} limit — E_GUARD_COUNT_EXCEEDED`,
|
|
144
|
-
description: `Guard count ${ctx.guard_count} >= MAX_GUARD_COUNT_PASSPORT=${MAX_GUARD_COUNT_PASSPORT}. guard_add on a new Guard aborts E_GUARD_COUNT_EXCEEDED (1). Existing Guards can still be updated, but no new ones can be added.`,
|
|
145
|
-
affected_stakeholders: ["creator"],
|
|
146
|
-
scenario: "Passport with many Guard dependencies (e.g. complex multi-factor verification)",
|
|
147
|
-
mitigation: `Plan Guard count reasonably within <= ${MAX_GUARD_COUNT_PASSPORT}. For more verifications, merge similar Guards or use relies logical composition.`,
|
|
148
|
-
evidence: `guard_count=${ctx.guard_count}, limit=${MAX_GUARD_COUNT_PASSPORT}`,
|
|
149
|
-
related_move_error: "E_GUARD_COUNT_EXCEEDED (1)",
|
|
150
|
-
auto_fixable: false,
|
|
151
|
-
};
|
|
152
|
-
},
|
|
153
|
-
};
|
|
154
|
-
const R_P_3_01 = {
|
|
155
|
-
id: "R-PASS-07",
|
|
156
|
-
category: "logic",
|
|
157
|
-
trigger: "impack Guard failure sets overall result=false; non-impack results are ignored",
|
|
158
|
-
check: (ctx) => {
|
|
159
|
-
if (ctx.operation_type !== "verify" && ctx.operation_type !== "use")
|
|
160
|
-
return null;
|
|
161
|
-
if (!ctx.has_impack_guard)
|
|
162
|
-
return null;
|
|
163
|
-
return {
|
|
164
|
-
id: "R-PASS-07",
|
|
165
|
-
level: "HIGH",
|
|
166
|
-
category: "logic",
|
|
167
|
-
title: "impack Guard failure sets overall result=false; non-impack results are ignored",
|
|
168
|
-
description: "During verify(), any impack=true Guard failure → immediately sets result=false and returns. Even if all impack=false Guards pass, they do not affect the final result. This may mislead users into thinking non-impack Guard success can salvage the overall result.",
|
|
169
|
-
affected_stakeholders: ["creator", "consumer"],
|
|
170
|
-
scenario: "Multi-Guard Passport where one impack Guard fails but non-impack Guards pass",
|
|
171
|
-
mitigation: "Only configure Guards that truly affect business outcomes as impack=true. Non-impack Guards are for logging/audit only. Audit the verify_guard logic of impack Guards to ensure correctness.",
|
|
172
|
-
evidence: `has_impack_guard=${ctx.has_impack_guard}`,
|
|
173
|
-
related_move_error: "E_VERIFY_FAILED (7, indirect)",
|
|
174
|
-
auto_fixable: false,
|
|
175
|
-
};
|
|
176
|
-
},
|
|
177
|
-
};
|
|
178
|
-
const R_P_3_02 = {
|
|
179
|
-
id: "R-PASS-08",
|
|
180
|
-
category: "logic",
|
|
181
|
-
trigger: "relies logic error (AND/OR misuse) causes verification logic to mismatch intent",
|
|
182
|
-
check: (ctx) => {
|
|
183
|
-
if (ctx.operation_type !== "guard_add" && ctx.operation_type !== "verify")
|
|
184
|
-
return null;
|
|
185
|
-
if (!ctx.relies_map)
|
|
186
|
-
return null;
|
|
187
|
-
const reliesCount = Object.values(ctx.relies_map).filter(r => r.length > 0).length;
|
|
188
|
-
if (reliesCount === 0)
|
|
189
|
-
return null;
|
|
190
|
-
return {
|
|
191
|
-
id: "R-PASS-08",
|
|
192
|
-
level: "HIGH",
|
|
193
|
-
category: "logic",
|
|
194
|
-
title: "relies logic error (AND/OR misuse) causes verification logic to mismatch intent",
|
|
195
|
-
description: `Detected ${reliesCount} Guard(s) using relies dependencies. relies_logic_and=true (AND) requires all dependencies to pass; relies_logic_and=false (OR) requires any dependency to pass. AND/OR misuse causes verification logic to diverge from business intent (e.g. intent is "any pass" but configured as AND, forcing all dependencies to pass).`,
|
|
196
|
-
affected_stakeholders: ["creator", "guard_owner"],
|
|
197
|
-
scenario: "Guard with relies on multiple dependencies, but logic operator misconfigured at Guard level",
|
|
198
|
-
mitigation: "Document each Guard's dependency relationships and expected logic. AND for 'all must satisfy' scenarios (multi-factor auth); OR for 'any satisfies' scenarios (multi-path authorization). Note: relies_logic_and is returned by guard::relies() of the Guard object, not configured at the Passport layer.",
|
|
199
|
-
evidence: `guards_with_relies=${reliesCount}`,
|
|
200
|
-
auto_fixable: false,
|
|
201
|
-
};
|
|
202
|
-
},
|
|
203
|
-
};
|
|
204
|
-
const R_P_3_03 = {
|
|
205
|
-
id: "R-PASS-09",
|
|
206
|
-
category: "knowledge",
|
|
207
|
-
trigger: "Constant sync gap — MAX_GUARD_COUNT/MAX_SUBMISSION_SIZE (RESOLVED)",
|
|
208
|
-
check: (ctx) => {
|
|
209
|
-
if (ctx.constants_synced === false) {
|
|
210
|
-
return {
|
|
211
|
-
id: "R-PASS-09",
|
|
212
|
-
level: "MEDIUM",
|
|
213
|
-
category: "knowledge",
|
|
214
|
-
title: "Constant sync gap: MAX_GUARD_COUNT/MAX_SUBMISSION_SIZE not synced",
|
|
215
|
-
description: "Move-layer MAX_GUARD_COUNT=20 / MAX_SUBMISSION_SIZE=256 were not synced to SDK onchain-constants.ts. Would cause SDK-layer pre-validation gaps or constant drift.",
|
|
216
|
-
affected_stakeholders: ["system"],
|
|
217
|
-
scenario: "Constant sync drift between Move / SDK / MCP",
|
|
218
|
-
mitigation: "Add MAX_GUARD_COUNT_PASSPORT=20 and MAX_SUBMISSION_SIZE_PASSPORT=256 to onchain-constants.ts",
|
|
219
|
-
evidence: "constants_synced=false",
|
|
220
|
-
resolved: false,
|
|
221
|
-
auto_fixable: true,
|
|
222
|
-
};
|
|
223
|
-
}
|
|
224
|
-
return {
|
|
225
|
-
id: "R-PASS-09",
|
|
226
|
-
level: "MEDIUM",
|
|
227
|
-
category: "knowledge",
|
|
228
|
-
title: "Constant sync gap (RESOLVED)",
|
|
229
|
-
description: "Historical issue: Move-layer MAX_GUARD_COUNT=20 / MAX_SUBMISSION_SIZE=256 were previously not synced to SDK. Fixed via onchain-constants.ts L278/L291 (ONCHAIN_CONSTANTS object) + L387/L392 (named exports). SDK passport.ts imports and re-exports these two constants from the top, no longer has local definitions.",
|
|
230
|
-
affected_stakeholders: ["system"],
|
|
231
|
-
scenario: "Constant sync drift between Move / SDK / MCP (historical, now resolved)",
|
|
232
|
-
mitigation: "Synced via MAX_GUARD_COUNT_PASSPORT / MAX_SUBMISSION_SIZE_PASSPORT. No further action required.",
|
|
233
|
-
evidence: `constants_synced=${ctx.constants_synced ?? true}, MAX_GUARD_COUNT_PASSPORT=${MAX_GUARD_COUNT_PASSPORT}, MAX_SUBMISSION_SIZE_PASSPORT=${MAX_SUBMISSION_SIZE_PASSPORT}`,
|
|
234
|
-
resolved: true,
|
|
235
|
-
auto_fixable: false,
|
|
236
|
-
};
|
|
237
|
-
},
|
|
238
|
-
};
|
|
239
|
-
const R_P_4_01 = {
|
|
240
|
-
id: "R-PASS-10",
|
|
241
|
-
category: "knowledge",
|
|
242
|
-
trigger: "Passport Knowledge layer completely missing (RESOLVED, 7/7)",
|
|
243
|
-
check: (ctx) => {
|
|
244
|
-
if (ctx.knowledge_files_present === false) {
|
|
245
|
-
return {
|
|
246
|
-
id: "R-PASS-10",
|
|
247
|
-
level: "CRITICAL",
|
|
248
|
-
category: "knowledge",
|
|
249
|
-
title: "Passport Knowledge layer completely missing (0/7)",
|
|
250
|
-
description: "Passport has no dedicated files under knowledge/ directory. AI Agent cannot access Passport knowledge via passport-context.ts aggregation, causing Passport operations to lack risk pre-checks, confirmation gates, translation rules, etc.",
|
|
251
|
-
affected_stakeholders: ["system"],
|
|
252
|
-
scenario: "AI Agent attempts Passport operation without knowledge layer",
|
|
253
|
-
mitigation: "Create 7 files: passport-{risk,confirm,translation,templates,context,puzzle,ledger}.ts",
|
|
254
|
-
evidence: "knowledge_files_present=false",
|
|
255
|
-
resolved: false,
|
|
256
|
-
auto_fixable: true,
|
|
257
|
-
};
|
|
258
|
-
}
|
|
259
|
-
return {
|
|
260
|
-
id: "R-PASS-10",
|
|
261
|
-
level: "CRITICAL",
|
|
262
|
-
category: "knowledge",
|
|
263
|
-
title: "Passport Knowledge layer completely missing (RESOLVED, 7/7)",
|
|
264
|
-
description: "Historical issue: Passport previously had no dedicated files under knowledge/ (0/7). Fixed by adding 7 files: passport-{risk,confirm,translation,templates,context,puzzle,ledger}.ts. AI Agent can now access Passport knowledge via passport-context.ts aggregation.",
|
|
265
|
-
affected_stakeholders: ["system"],
|
|
266
|
-
scenario: "AI Agent attempts Passport operation (historical gap, now resolved)",
|
|
267
|
-
mitigation: "7 knowledge files created. No further action required.",
|
|
268
|
-
evidence: `knowledge_files_present=${ctx.knowledge_files_present ?? true}`,
|
|
269
|
-
resolved: true,
|
|
270
|
-
auto_fixable: false,
|
|
271
|
-
};
|
|
272
|
-
},
|
|
273
|
-
};
|
|
274
|
-
const R_P_4_02 = {
|
|
275
|
-
id: "R-PASS-11",
|
|
276
|
-
category: "operational",
|
|
277
|
-
trigger: "No event emission — Passport creation/verify history cannot be tracked via events",
|
|
278
|
-
check: (ctx) => {
|
|
279
|
-
if (ctx.operation_type !== "create" && ctx.operation_type !== "verify")
|
|
280
|
-
return null;
|
|
281
|
-
return {
|
|
282
|
-
id: "R-PASS-11",
|
|
283
|
-
level: "MEDIUM",
|
|
284
|
-
category: "operational",
|
|
285
|
-
title: "No event emission — Passport creation/verify history cannot be tracked via events",
|
|
286
|
-
description: "Passport structurally has 0 event emissions (unlike Order which emits NewOrderEvent). Passport creation, Guard addition, verify, and other operations cannot be tracked via the Wow event system. Auditors must proactively query object state (query_objects with ObjectType.Passport).",
|
|
287
|
-
affected_stakeholders: ["system", "consumer"],
|
|
288
|
-
scenario: "Auditor attempts to reconstruct Passport lifecycle from events",
|
|
289
|
-
mitigation: "Proactively fetch Passport state via query interfaces (ObjectPassportSchema). Downstream consumers should record their own business events and correlate them with Passport object addresses.",
|
|
290
|
-
evidence: "0 events in passport.move",
|
|
291
|
-
auto_fixable: false,
|
|
292
|
-
};
|
|
293
|
-
},
|
|
294
|
-
};
|
|
295
|
-
const R_P_4_03 = {
|
|
296
|
-
id: "R-PASS-12",
|
|
297
|
-
category: "operational",
|
|
298
|
-
trigger: "result_for_permission lazy-loads impack field",
|
|
299
|
-
check: (ctx) => {
|
|
300
|
-
if (ctx.operation_type !== "use")
|
|
301
|
-
return null;
|
|
302
|
-
return {
|
|
303
|
-
id: "R-PASS-12",
|
|
304
|
-
level: "LOW",
|
|
305
|
-
category: "operational",
|
|
306
|
-
title: "result_for_permission lazy-loads impack field",
|
|
307
|
-
description: "The Passport.impack field (vector<address>) is NOT populated at verify() time; it is lazily loaded only on the first call to result_for_permission(). This means querying ObjectPassport.impack_guard after verify but before result_for_permission is called may return an empty array.",
|
|
308
|
-
affected_stakeholders: ["consumer", "system"],
|
|
309
|
-
scenario: "Consumer queries impack_guard list before result_for_permission is called",
|
|
310
|
-
mitigation: "Document the lazy-loading behavior. To get the impack list immediately, call result_for_permission() explicitly. Note: this function checks result=true (E_VERIFY_FAILED if false).",
|
|
311
|
-
evidence: "impack field lazy-filled in result_for_permission()",
|
|
312
|
-
auto_fixable: false,
|
|
313
|
-
};
|
|
314
|
-
},
|
|
315
|
-
};
|
|
316
|
-
const R_P_5_01 = {
|
|
317
|
-
id: "R-PASS-13",
|
|
318
|
-
category: "lifecycle",
|
|
319
|
-
trigger: "destroy must occur before freeze — frozen object cannot be destroyed",
|
|
320
|
-
check: (ctx) => {
|
|
321
|
-
if (ctx.operation_type !== "destroy" && ctx.operation_type !== "freezen")
|
|
322
|
-
return null;
|
|
323
|
-
if (ctx.is_frozen) {
|
|
324
|
-
return {
|
|
325
|
-
id: "R-PASS-13",
|
|
326
|
-
level: "INFO",
|
|
327
|
-
category: "lifecycle",
|
|
328
|
-
title: "destroy must occur before freeze — frozen object cannot be destroyed",
|
|
329
|
-
description: "Passport is frozen (becomes immutable after freeze_object). destroy() needs to receive self: Passport by value, but a frozen object can no longer be received by value. To destroy, the operation must happen before freeze.",
|
|
330
|
-
affected_stakeholders: ["creator"],
|
|
331
|
-
scenario: "Creator attempts to destroy a frozen Passport",
|
|
332
|
-
mitigation: "Document the workflow: destroy and freezen are mutually exclusive terminal operations. Freeze = permanent retention; destroy = resource release.",
|
|
333
|
-
evidence: `is_frozen=${ctx.is_frozen}`,
|
|
334
|
-
auto_fixable: false,
|
|
335
|
-
};
|
|
336
|
-
}
|
|
337
|
-
return {
|
|
338
|
-
id: "R-PASS-13",
|
|
339
|
-
level: "INFO",
|
|
340
|
-
category: "lifecycle",
|
|
341
|
-
title: "destroy must occur before freeze — workflow reminder",
|
|
342
|
-
description: "destroy and freezen are two terminal operations for Passport. destroy releases resources (object::delete); freezen permanently retains (transfer::freeze_object). The two are mutually exclusive: after freeze, destroy is not allowed; after destroy, freeze is not allowed.",
|
|
343
|
-
affected_stakeholders: ["creator"],
|
|
344
|
-
scenario: "Creator choosing between destroy and freezen",
|
|
345
|
-
mitigation: "Use freezen to permanently retain verification records (for audit); use destroy for one-time verification (to release gas storage fees).",
|
|
346
|
-
evidence: `operation=${ctx.operation_type}`,
|
|
347
|
-
auto_fixable: false,
|
|
348
|
-
};
|
|
349
|
-
},
|
|
350
|
-
};
|
|
351
|
-
const R_P_5_02 = {
|
|
352
|
-
id: "R-PASS-14",
|
|
353
|
-
category: "logic",
|
|
354
|
-
trigger: "Depended Guard cannot have its own dependencies — restricts complex verification logic",
|
|
355
|
-
check: (ctx) => {
|
|
356
|
-
if (!ctx.has_transitive_relies)
|
|
357
|
-
return null;
|
|
358
|
-
return {
|
|
359
|
-
id: "R-PASS-14",
|
|
360
|
-
level: "LOW",
|
|
361
|
-
category: "logic",
|
|
362
|
-
title: "Depended Guard cannot have its own dependencies — restricts complex verification logic",
|
|
363
|
-
description: "Passport's relies mechanism forbids transitive dependencies: a relied-upon Guard cannot have its own relies. This means 'A depends on B, B depends on C' chain verification cannot be modeled. Complex verification logic must be flattened to single-layer dependencies or split into multiple Passports.",
|
|
364
|
-
affected_stakeholders: ["creator", "guard_owner"],
|
|
365
|
-
scenario: "Designer attempts to model transitive Guard dependencies",
|
|
366
|
-
mitigation: "Accept the design constraint. For chain verification, flatten all dependency Guards into a single-layer AND dependency, or use Machine workflows to model multi-stage verification.",
|
|
367
|
-
evidence: `has_transitive_relies=${ctx.has_transitive_relies}`,
|
|
368
|
-
auto_fixable: false,
|
|
369
|
-
};
|
|
370
|
-
},
|
|
371
|
-
};
|
|
372
|
-
const R_P_5_03 = {
|
|
373
|
-
id: "R-PASS-15",
|
|
374
|
-
category: "operational",
|
|
375
|
-
trigger: "verify_guard is a native function — verification logic is opaque",
|
|
376
|
-
check: (ctx) => {
|
|
377
|
-
if (ctx.operation_type !== "verify")
|
|
378
|
-
return null;
|
|
379
|
-
return {
|
|
380
|
-
id: "R-PASS-15",
|
|
381
|
-
level: "INFO",
|
|
382
|
-
category: "operational",
|
|
383
|
-
title: "verify_guard is a native function — verification logic is opaque",
|
|
384
|
-
description: "guard::verify_guard(passport, guard, submission, impack) is a native function; its internal implementation is not visible in Move source code. The verification logic (how submission is parsed, how Guard table is matched, how result is returned) is implemented by the Wow runtime. Developers cannot fully understand verification details by reading Move source code.",
|
|
385
|
-
affected_stakeholders: ["creator", "guard_owner"],
|
|
386
|
-
scenario: "Developer attempts to debug verify() failure",
|
|
387
|
-
mitigation: "Document native behavior: verify_guard verifies submission item-by-item per Guard.table config; types must match. Returns false on failure (does not abort). To debug, test each Guard's submission individually.",
|
|
388
|
-
evidence: "guard::verify_guard is native",
|
|
389
|
-
auto_fixable: false,
|
|
390
|
-
};
|
|
391
|
-
},
|
|
392
|
-
};
|
|
393
|
-
const ALL_RULES = [
|
|
394
|
-
R_P_1_01, R_P_1_02, R_P_1_03,
|
|
395
|
-
R_P_2_01, R_P_2_02, R_P_2_03,
|
|
396
|
-
R_P_3_01, R_P_3_02, R_P_3_03,
|
|
397
|
-
R_P_4_01, R_P_4_02, R_P_4_03,
|
|
398
|
-
R_P_5_01, R_P_5_02, R_P_5_03,
|
|
399
|
-
];
|
|
400
|
-
export const PASSPORT_RISK_VERSION = "1.0.0";
|
|
401
|
-
export function getAllRiskRules() {
|
|
402
|
-
return [...ALL_RULES];
|
|
403
|
-
}
|
|
404
|
-
export function getRiskRulesCount() {
|
|
405
|
-
return ALL_RULES.length;
|
|
406
|
-
}
|
|
407
|
-
export function getRiskRulesByCategory(category) {
|
|
408
|
-
return ALL_RULES.filter(r => r.category === category);
|
|
409
|
-
}
|
|
410
|
-
export function assessPassportRisks(ctx) {
|
|
411
|
-
const risks = [];
|
|
412
|
-
for (const rule of ALL_RULES) {
|
|
413
|
-
const r = rule.check(ctx);
|
|
414
|
-
if (r)
|
|
415
|
-
risks.push(r);
|
|
416
|
-
}
|
|
417
|
-
const levelRank = {
|
|
418
|
-
CRITICAL: 4, HIGH: 3, MEDIUM: 2, LOW: 1, INFO: 0,
|
|
419
|
-
};
|
|
420
|
-
const overall = risks.length === 0
|
|
421
|
-
? "LOW"
|
|
422
|
-
: risks.reduce((max, r) => levelRank[r.level] > levelRank[max] ? r.level : max, "INFO");
|
|
423
|
-
const byCategory = {};
|
|
424
|
-
const byLevel = {};
|
|
425
|
-
for (const r of risks) {
|
|
426
|
-
byCategory[r.category] = (byCategory[r.category] ?? 0) + 1;
|
|
427
|
-
byLevel[r.level] = (byLevel[r.level] ?? 0) + 1;
|
|
428
|
-
}
|
|
429
|
-
const advice = {};
|
|
430
|
-
for (const r of risks) {
|
|
431
|
-
for (const s of r.affected_stakeholders) {
|
|
432
|
-
if (!advice[s])
|
|
433
|
-
advice[s] = [];
|
|
434
|
-
advice[s].push(`${r.id}: ${r.mitigation}`);
|
|
435
|
-
}
|
|
436
|
-
}
|
|
437
|
-
const blockingRisks = risks.filter(r => r.level === "CRITICAL" && !r.resolved);
|
|
438
|
-
const reviewRisks = risks.filter(r => (r.level === "CRITICAL" || r.level === "HIGH") && !r.resolved);
|
|
439
|
-
return {
|
|
440
|
-
summary: `Assessed ${risks.length} risk(s) across ${Object.keys(byCategory).length} categories`,
|
|
441
|
-
risks,
|
|
442
|
-
overall_risk: overall,
|
|
443
|
-
risks_by_category: byCategory,
|
|
444
|
-
risks_by_level: byLevel,
|
|
445
|
-
stakeholder_advice: advice,
|
|
446
|
-
needs_human_review: reviewRisks.length > 0,
|
|
447
|
-
blocks_publish: blockingRisks.length > 0,
|
|
448
|
-
};
|
|
449
|
-
}
|
|
450
|
-
export { PASSPORT_ERROR_CODES };
|
|
1
|
+
import{MAX_GUARD_COUNT_PASSPORT,MAX_SUBMISSION_SIZE_PASSPORT,PASSPORT_ERROR_CODES}from'./passport-ledger.js';const R_P_1_01={'id':'R-PASS-01','category':'lifecycle','trigger':'tx_hash\x20binding\x20—\x20Passport\x20cannot\x20be\x20reused\x20across\x20transactions','check':a=>{if(a['operation_type']!=='create'&&a['operation_type']!=='use')return null;return{'id':'R-PASS-01','level':'HIGH','category':'lifecycle','title':'tx_hash\x20binding\x20—\x20Passport\x20cannot\x20be\x20reused\x20across\x20transactions','description':'Passport\x20is\x20bound\x20to\x20tx_context::digest(ctx)\x20at\x20creation\x20time.\x20All\x20write\x20functions\x20(guard_add\x20/\x20guard_clear\x20/\x20verify)\x20and\x20result\x20queries\x20require\x20tx_hash\x20to\x20match\x20the\x20current\x20transaction,\x20otherwise\x20abort\x20E_DIGEST_NOT_MATCH\x20(11)\x20or\x20E_TX_NOT_MATCH\x20(8).\x20Caller\x20must\x20complete\x20all\x20operations\x20within\x20the\x20same\x20transaction\x20(new\x20→\x20guard_add\x20→\x20verify\x20→\x20result\x20→\x20consume).','affected_stakeholders':['creator','consumer'],'scenario':'Caller\x20attempts\x20to\x20use\x20Passport\x20created\x20in\x20a\x20previous\x20transaction','mitigation':'SDK\x20encapsulates\x20single-transaction\x20flow\x20(verify_guard:\x20new\x20→\x20guard_add\x20→\x20verify\x20→\x20freeze).\x20To\x20reuse\x20across\x20transactions,\x20you\x20must\x20recreate\x20the\x20Passport\x20and\x20resubmit\x20all\x20Guard\x20data.','evidence':'tx_hash\x20field\x20set\x20at\x20new()\x20time,\x20enforced\x20in\x20guard_add/verify/result','related_move_error':'E_DIGEST_NOT_MATCH\x20(11),\x20E_TX_NOT_MATCH\x20(8)','auto_fixable':![]};}},R_P_1_02={'id':'R-PASS-02','category':'lifecycle','trigger':'has_verified\x20one-time\x20—\x20Guard\x20config\x20cannot\x20be\x20modified\x20after\x20verify','check':a=>{if(!a['has_verified'])return null;if(a['operation_type']!=='guard_add'&&a['operation_type']!=='guard_clear')return null;return{'id':'R-PASS-02','level':'MEDIUM','category':'lifecycle','title':'has_verified\x20one-time\x20—\x20Guard\x20config\x20cannot\x20be\x20modified\x20after\x20verify','description':'After\x20Passport.has_verified=true,\x20guard_add\x20/\x20guard_clear\x20/\x20verify\x20all\x20abort\x20E_HAS_VERIFIED\x20(4).\x20verify\x20is\x20a\x20one-time\x20operation\x20and\x20its\x20result\x20is\x20tamper-proof.\x20This\x20is\x20Passport\x27s\x20core\x20security\x20guarantee\x20(anti-tampering),\x20but\x20also\x20means\x20all\x20Guards\x20must\x20be\x20fully\x20configured\x20before\x20verify.','affected_stakeholders':['creator'],'scenario':'Caller\x20attempts\x20to\x20modify\x20Guard\x20configuration\x20after\x20verify()','mitigation':'Fully\x20plan\x20all\x20Guards\x20(impack\x20+\x20non-impack\x20+\x20relies\x20dependencies)\x20before\x20verify().\x20To\x20modify\x20after\x20verify,\x20create\x20a\x20new\x20Passport.','evidence':'has_verified='+a['has_verified']+',\x20operation='+a['operation_type'],'related_move_error':'E_HAS_VERIFIED\x20(4)','auto_fixable':![]};}},R_P_1_03={'id':'R-PASS-03','category':'structural','trigger':'No\x20impack\x20Guard\x20—\x20verify\x20will\x20fail\x20E_IMPACK_GUARD_NOT_FOUND','check':a=>{if(a['operation_type']!=='verify')return null;if(a['has_impack_guard'])return null;return{'id':'R-PASS-03','level':'MEDIUM','category':'structural','title':'No\x20impack\x20Guard\x20—\x20verify\x20will\x20fail\x20E_IMPACK_GUARD_NOT_FOUND','description':'verify()\x20requires\x20at\x20least\x201\x20impack=true\x20Guard.\x20If\x20all\x20Guards\x20are\x20impack=false,\x20verify\x20aborts\x20E_IMPACK_GUARD_NOT_FOUND\x20(9).\x20Guards\x20with\x20impack=false\x20only\x20record\x20per-Guard\x20result\x20and\x20do\x20not\x20affect\x20the\x20final\x20result.','affected_stakeholders':['creator'],'scenario':'Passport\x20configured\x20with\x20only\x20non-impack\x20Guards','mitigation':'Configure\x20at\x20least\x201\x20Guard\x20as\x20impack=true.\x20Failure\x20of\x20this\x20Guard\x20immediately\x20sets\x20the\x20overall\x20result=false.','evidence':'has_impack_guard='+(a['has_impack_guard']??![]),'related_move_error':'E_IMPACK_GUARD_NOT_FOUND\x20(9)','auto_fixable':!![]};}},R_P_2_01={'id':'R-PASS-04','category':'logic','trigger':'Depended\x20Guard\x20order\x20error\x20—\x20E_RELIES_GUARD_NOT_ADDED','check':a=>{if(a['operation_type']!=='guard_add')return null;if(!a['relies_map'])return null;const b=new Set(a['guard_config']?.['guard']['map'](c=>c['object'])??[]);for(const [c,d]of Object['entries'](a['relies_map'])){if(!b['has'](c))continue;for(const e of d){if(!b['has'](e))return{'id':'R-PASS-04','level':'HIGH','category':'logic','title':'Depended\x20Guard\x20order\x20error\x20—\x20E_RELIES_GUARD_NOT_ADDED','description':'Guard\x20'+c+'\x20depends\x20on\x20Guard\x20'+e+',\x20but\x20'+e+'\x20has\x20not\x20been\x20added\x20to\x20Passport\x20yet.\x20guard_add\x20checks\x20dependencies\x20in\x20topological\x20order;\x20if\x20a\x20depended\x20Guard\x20was\x20not\x20added\x20first,\x20abort\x20E_RELIES_GUARD_NOT_ADDED\x20(2).','affected_stakeholders':['creator'],'scenario':'Adding\x20a\x20Guard\x20with\x20relies\x20before\x20adding\x20the\x20relied\x20Guard','mitigation':'Add\x20the\x20depended\x20Guard\x20'+e+'\x20first,\x20then\x20'+c+'.\x20Dependencies\x20are\x20returned\x20by\x20guard::relies(guard).','evidence':'guard='+c+',\x20missing_rely='+e,'related_move_error':'E_RELIES_GUARD_NOT_ADDED\x20(2)','auto_fixable':![]};}}return null;}},R_P_2_02={'id':'R-PASS-05','category':'structural','trigger':'submission\x20serialized\x20exceeds\x20256\x20bytes\x20—\x20E_SUBMISSION_SIZE_EXCEEDED','check':a=>{if(a['max_submission_size']===undefined)return null;if(a['max_submission_size']<=MAX_SUBMISSION_SIZE_PASSPORT)return null;return{'id':'R-PASS-05','level':'MEDIUM','category':'structural','title':'submission\x20serialized\x20exceeds\x20'+MAX_SUBMISSION_SIZE_PASSPORT+'\x20bytes\x20—\x20E_SUBMISSION_SIZE_EXCEEDED','description':'Single\x20submission\x20serialized\x20size\x20is\x20'+a['max_submission_size']+'\x20bytes\x20>\x20MAX_SUBMISSION_SIZE_PASSPORT='+MAX_SUBMISSION_SIZE_PASSPORT+'.\x20verify()\x20checks\x20BCS\x20serialized\x20size\x20of\x20each\x20submission;\x20if\x20exceeded,\x20abort\x20E_SUBMISSION_SIZE_EXCEEDED\x20(3).','affected_stakeholders':['creator'],'scenario':'Submission\x20value\x20too\x20large\x20(e.g.\x20long\x20string\x20or\x20nested\x20struct)','mitigation':'Trim\x20submission\x20data\x20to\x20<=\x20'+MAX_SUBMISSION_SIZE_PASSPORT+'\x20bytes.\x20For\x20large\x20objects,\x20use\x20Repository\x20references\x20instead\x20of\x20inline\x20data.','evidence':'max_submission_size='+a['max_submission_size']+',\x20limit='+MAX_SUBMISSION_SIZE_PASSPORT,'related_move_error':'E_SUBMISSION_SIZE_EXCEEDED\x20(3)','auto_fixable':![]};}},R_P_2_03={'id':'R-PASS-06','category':'structural','trigger':'Guard\x20count\x20reaches\x2020\x20limit\x20—\x20E_GUARD_COUNT_EXCEEDED','check':a=>{if(a['guard_count']===undefined)return null;if(a['guard_count']<MAX_GUARD_COUNT_PASSPORT)return null;return{'id':'R-PASS-06','level':'LOW','category':'structural','title':'Guard\x20count\x20reaches\x20'+MAX_GUARD_COUNT_PASSPORT+'\x20limit\x20—\x20E_GUARD_COUNT_EXCEEDED','description':'Guard\x20count\x20'+a['guard_count']+'\x20>=\x20MAX_GUARD_COUNT_PASSPORT='+MAX_GUARD_COUNT_PASSPORT+'.\x20guard_add\x20on\x20a\x20new\x20Guard\x20aborts\x20E_GUARD_COUNT_EXCEEDED\x20(1).\x20Existing\x20Guards\x20can\x20still\x20be\x20updated,\x20but\x20no\x20new\x20ones\x20can\x20be\x20added.','affected_stakeholders':['creator'],'scenario':'Passport\x20with\x20many\x20Guard\x20dependencies\x20(e.g.\x20complex\x20multi-factor\x20verification)','mitigation':'Plan\x20Guard\x20count\x20reasonably\x20within\x20<=\x20'+MAX_GUARD_COUNT_PASSPORT+'.\x20For\x20more\x20verifications,\x20merge\x20similar\x20Guards\x20or\x20use\x20relies\x20logical\x20composition.','evidence':'guard_count='+a['guard_count']+',\x20limit='+MAX_GUARD_COUNT_PASSPORT,'related_move_error':'E_GUARD_COUNT_EXCEEDED\x20(1)','auto_fixable':![]};}},R_P_3_01={'id':'R-PASS-07','category':'logic','trigger':'impack\x20Guard\x20failure\x20sets\x20overall\x20result=false;\x20non-impack\x20results\x20are\x20ignored','check':a=>{if(a['operation_type']!=='verify'&&a['operation_type']!=='use')return null;if(!a['has_impack_guard'])return null;return{'id':'R-PASS-07','level':'HIGH','category':'logic','title':'impack\x20Guard\x20failure\x20sets\x20overall\x20result=false;\x20non-impack\x20results\x20are\x20ignored','description':'During\x20verify(),\x20any\x20impack=true\x20Guard\x20failure\x20→\x20immediately\x20sets\x20result=false\x20and\x20returns.\x20Even\x20if\x20all\x20impack=false\x20Guards\x20pass,\x20they\x20do\x20not\x20affect\x20the\x20final\x20result.\x20This\x20may\x20mislead\x20users\x20into\x20thinking\x20non-impack\x20Guard\x20success\x20can\x20salvage\x20the\x20overall\x20result.','affected_stakeholders':['creator','consumer'],'scenario':'Multi-Guard\x20Passport\x20where\x20one\x20impack\x20Guard\x20fails\x20but\x20non-impack\x20Guards\x20pass','mitigation':'Only\x20configure\x20Guards\x20that\x20truly\x20affect\x20business\x20outcomes\x20as\x20impack=true.\x20Non-impack\x20Guards\x20are\x20for\x20logging/audit\x20only.\x20Audit\x20the\x20verify_guard\x20logic\x20of\x20impack\x20Guards\x20to\x20ensure\x20correctness.','evidence':'has_impack_guard='+a['has_impack_guard'],'related_move_error':'E_VERIFY_FAILED\x20(7,\x20indirect)','auto_fixable':![]};}},R_P_3_02={'id':'R-PASS-08','category':'logic','trigger':'relies\x20logic\x20error\x20(AND/OR\x20misuse)\x20causes\x20verification\x20logic\x20to\x20mismatch\x20intent','check':a=>{if(a['operation_type']!=='guard_add'&&a['operation_type']!=='verify')return null;if(!a['relies_map'])return null;const b=Object['values'](a['relies_map'])['filter'](c=>c['length']>0x0)['length'];if(b===0x0)return null;return{'id':'R-PASS-08','level':'HIGH','category':'logic','title':'relies\x20logic\x20error\x20(AND/OR\x20misuse)\x20causes\x20verification\x20logic\x20to\x20mismatch\x20intent','description':'Detected\x20'+b+'\x20Guard(s)\x20using\x20relies\x20dependencies.\x20relies_logic_and=true\x20(AND)\x20requires\x20all\x20dependencies\x20to\x20pass;\x20relies_logic_and=false\x20(OR)\x20requires\x20any\x20dependency\x20to\x20pass.\x20AND/OR\x20misuse\x20causes\x20verification\x20logic\x20to\x20diverge\x20from\x20business\x20intent\x20(e.g.\x20intent\x20is\x20\x22any\x20pass\x22\x20but\x20configured\x20as\x20AND,\x20forcing\x20all\x20dependencies\x20to\x20pass).','affected_stakeholders':['creator','guard_owner'],'scenario':'Guard\x20with\x20relies\x20on\x20multiple\x20dependencies,\x20but\x20logic\x20operator\x20misconfigured\x20at\x20Guard\x20level','mitigation':'Document\x20each\x20Guard\x27s\x20dependency\x20relationships\x20and\x20expected\x20logic.\x20AND\x20for\x20\x27all\x20must\x20satisfy\x27\x20scenarios\x20(multi-factor\x20auth);\x20OR\x20for\x20\x27any\x20satisfies\x27\x20scenarios\x20(multi-path\x20authorization).\x20Note:\x20relies_logic_and\x20is\x20returned\x20by\x20guard::relies()\x20of\x20the\x20Guard\x20object,\x20not\x20configured\x20at\x20the\x20Passport\x20layer.','evidence':'guards_with_relies='+b,'auto_fixable':![]};}},R_P_3_03={'id':'R-PASS-09','category':'knowledge','trigger':'Constant\x20sync\x20gap\x20—\x20MAX_GUARD_COUNT/MAX_SUBMISSION_SIZE\x20(RESOLVED)','check':a=>{if(a['constants_synced']===![])return{'id':'R-PASS-09','level':'MEDIUM','category':'knowledge','title':'Constant\x20sync\x20gap:\x20MAX_GUARD_COUNT/MAX_SUBMISSION_SIZE\x20not\x20synced','description':'Move-layer\x20MAX_GUARD_COUNT=20\x20/\x20MAX_SUBMISSION_SIZE=256\x20were\x20not\x20synced\x20to\x20SDK\x20onchain-constants.ts.\x20Would\x20cause\x20SDK-layer\x20pre-validation\x20gaps\x20or\x20constant\x20drift.','affected_stakeholders':['system'],'scenario':'Constant\x20sync\x20drift\x20between\x20Move\x20/\x20SDK\x20/\x20MCP','mitigation':'Add\x20MAX_GUARD_COUNT_PASSPORT=20\x20and\x20MAX_SUBMISSION_SIZE_PASSPORT=256\x20to\x20onchain-constants.ts','evidence':'constants_synced=false','resolved':![],'auto_fixable':!![]};return{'id':'R-PASS-09','level':'MEDIUM','category':'knowledge','title':'Constant\x20sync\x20gap\x20(RESOLVED)','description':'Historical\x20issue:\x20Move-layer\x20MAX_GUARD_COUNT=20\x20/\x20MAX_SUBMISSION_SIZE=256\x20were\x20previously\x20not\x20synced\x20to\x20SDK.\x20Fixed\x20via\x20onchain-constants.ts\x20L278/L291\x20(ONCHAIN_CONSTANTS\x20object)\x20+\x20L387/L392\x20(named\x20exports).\x20SDK\x20passport.ts\x20imports\x20and\x20re-exports\x20these\x20two\x20constants\x20from\x20the\x20top,\x20no\x20longer\x20has\x20local\x20definitions.','affected_stakeholders':['system'],'scenario':'Constant\x20sync\x20drift\x20between\x20Move\x20/\x20SDK\x20/\x20MCP\x20(historical,\x20now\x20resolved)','mitigation':'Synced\x20via\x20MAX_GUARD_COUNT_PASSPORT\x20/\x20MAX_SUBMISSION_SIZE_PASSPORT.\x20No\x20further\x20action\x20required.','evidence':'constants_synced='+(a['constants_synced']??!![])+',\x20MAX_GUARD_COUNT_PASSPORT='+MAX_GUARD_COUNT_PASSPORT+',\x20MAX_SUBMISSION_SIZE_PASSPORT='+MAX_SUBMISSION_SIZE_PASSPORT,'resolved':!![],'auto_fixable':![]};}},R_P_4_01={'id':'R-PASS-10','category':'knowledge','trigger':'Passport\x20Knowledge\x20layer\x20completely\x20missing\x20(RESOLVED,\x207/7)','check':a=>{if(a['knowledge_files_present']===![])return{'id':'R-PASS-10','level':'CRITICAL','category':'knowledge','title':'Passport\x20Knowledge\x20layer\x20completely\x20missing\x20(0/7)','description':'Passport\x20has\x20no\x20dedicated\x20files\x20under\x20knowledge/\x20directory.\x20AI\x20Agent\x20cannot\x20access\x20Passport\x20knowledge\x20via\x20passport-context.ts\x20aggregation,\x20causing\x20Passport\x20operations\x20to\x20lack\x20risk\x20pre-checks,\x20confirmation\x20gates,\x20translation\x20rules,\x20etc.','affected_stakeholders':['system'],'scenario':'AI\x20Agent\x20attempts\x20Passport\x20operation\x20without\x20knowledge\x20layer','mitigation':'Create\x207\x20files:\x20passport-{risk,confirm,translation,templates,context,puzzle,ledger}.ts','evidence':'knowledge_files_present=false','resolved':![],'auto_fixable':!![]};return{'id':'R-PASS-10','level':'CRITICAL','category':'knowledge','title':'Passport\x20Knowledge\x20layer\x20completely\x20missing\x20(RESOLVED,\x207/7)','description':'Historical\x20issue:\x20Passport\x20previously\x20had\x20no\x20dedicated\x20files\x20under\x20knowledge/\x20(0/7).\x20Fixed\x20by\x20adding\x207\x20files:\x20passport-{risk,confirm,translation,templates,context,puzzle,ledger}.ts.\x20AI\x20Agent\x20can\x20now\x20access\x20Passport\x20knowledge\x20via\x20passport-context.ts\x20aggregation.','affected_stakeholders':['system'],'scenario':'AI\x20Agent\x20attempts\x20Passport\x20operation\x20(historical\x20gap,\x20now\x20resolved)','mitigation':'7\x20knowledge\x20files\x20created.\x20No\x20further\x20action\x20required.','evidence':'knowledge_files_present='+(a['knowledge_files_present']??!![]),'resolved':!![],'auto_fixable':![]};}},R_P_4_02={'id':'R-PASS-11','category':'operational','trigger':'No\x20event\x20emission\x20—\x20Passport\x20creation/verify\x20history\x20cannot\x20be\x20tracked\x20via\x20events','check':a=>{if(a['operation_type']!=='create'&&a['operation_type']!=='verify')return null;return{'id':'R-PASS-11','level':'MEDIUM','category':'operational','title':'No\x20event\x20emission\x20—\x20Passport\x20creation/verify\x20history\x20cannot\x20be\x20tracked\x20via\x20events','description':'Passport\x20structurally\x20has\x200\x20event\x20emissions\x20(unlike\x20Order\x20which\x20emits\x20NewOrderEvent).\x20Passport\x20creation,\x20Guard\x20addition,\x20verify,\x20and\x20other\x20operations\x20cannot\x20be\x20tracked\x20via\x20the\x20Wow\x20event\x20system.\x20Auditors\x20must\x20proactively\x20query\x20object\x20state\x20(query_objects\x20with\x20ObjectType.Passport).','affected_stakeholders':['system','consumer'],'scenario':'Auditor\x20attempts\x20to\x20reconstruct\x20Passport\x20lifecycle\x20from\x20events','mitigation':'Proactively\x20fetch\x20Passport\x20state\x20via\x20query\x20interfaces\x20(ObjectPassportSchema).\x20Downstream\x20consumers\x20should\x20record\x20their\x20own\x20business\x20events\x20and\x20correlate\x20them\x20with\x20Passport\x20object\x20addresses.','evidence':'0\x20events\x20in\x20passport.move','auto_fixable':![]};}},R_P_4_03={'id':'R-PASS-12','category':'operational','trigger':'result_for_permission\x20lazy-loads\x20impack\x20field','check':a=>{if(a['operation_type']!=='use')return null;return{'id':'R-PASS-12','level':'LOW','category':'operational','title':'result_for_permission\x20lazy-loads\x20impack\x20field','description':'The\x20Passport.impack\x20field\x20(vector<address>)\x20is\x20NOT\x20populated\x20at\x20verify()\x20time;\x20it\x20is\x20lazily\x20loaded\x20only\x20on\x20the\x20first\x20call\x20to\x20result_for_permission().\x20This\x20means\x20querying\x20ObjectPassport.impack_guard\x20after\x20verify\x20but\x20before\x20result_for_permission\x20is\x20called\x20may\x20return\x20an\x20empty\x20array.','affected_stakeholders':['consumer','system'],'scenario':'Consumer\x20queries\x20impack_guard\x20list\x20before\x20result_for_permission\x20is\x20called','mitigation':'Document\x20the\x20lazy-loading\x20behavior.\x20To\x20get\x20the\x20impack\x20list\x20immediately,\x20call\x20result_for_permission()\x20explicitly.\x20Note:\x20this\x20function\x20checks\x20result=true\x20(E_VERIFY_FAILED\x20if\x20false).','evidence':'impack\x20field\x20lazy-filled\x20in\x20result_for_permission()','auto_fixable':![]};}},R_P_5_01={'id':'R-PASS-13','category':'lifecycle','trigger':'destroy\x20must\x20occur\x20before\x20freeze\x20—\x20frozen\x20object\x20cannot\x20be\x20destroyed','check':a=>{if(a['operation_type']!=='destroy'&&a['operation_type']!=='freezen')return null;if(a['is_frozen'])return{'id':'R-PASS-13','level':'INFO','category':'lifecycle','title':'destroy\x20must\x20occur\x20before\x20freeze\x20—\x20frozen\x20object\x20cannot\x20be\x20destroyed','description':'Passport\x20is\x20frozen\x20(becomes\x20immutable\x20after\x20freeze_object).\x20destroy()\x20needs\x20to\x20receive\x20self:\x20Passport\x20by\x20value,\x20but\x20a\x20frozen\x20object\x20can\x20no\x20longer\x20be\x20received\x20by\x20value.\x20To\x20destroy,\x20the\x20operation\x20must\x20happen\x20before\x20freeze.','affected_stakeholders':['creator'],'scenario':'Creator\x20attempts\x20to\x20destroy\x20a\x20frozen\x20Passport','mitigation':'Document\x20the\x20workflow:\x20destroy\x20and\x20freezen\x20are\x20mutually\x20exclusive\x20terminal\x20operations.\x20Freeze\x20=\x20permanent\x20retention;\x20destroy\x20=\x20resource\x20release.','evidence':'is_frozen='+a['is_frozen'],'auto_fixable':![]};return{'id':'R-PASS-13','level':'INFO','category':'lifecycle','title':'destroy\x20must\x20occur\x20before\x20freeze\x20—\x20workflow\x20reminder','description':'destroy\x20and\x20freezen\x20are\x20two\x20terminal\x20operations\x20for\x20Passport.\x20destroy\x20releases\x20resources\x20(object::delete);\x20freezen\x20permanently\x20retains\x20(transfer::freeze_object).\x20The\x20two\x20are\x20mutually\x20exclusive:\x20after\x20freeze,\x20destroy\x20is\x20not\x20allowed;\x20after\x20destroy,\x20freeze\x20is\x20not\x20allowed.','affected_stakeholders':['creator'],'scenario':'Creator\x20choosing\x20between\x20destroy\x20and\x20freezen','mitigation':'Use\x20freezen\x20to\x20permanently\x20retain\x20verification\x20records\x20(for\x20audit);\x20use\x20destroy\x20for\x20one-time\x20verification\x20(to\x20release\x20gas\x20storage\x20fees).','evidence':'operation='+a['operation_type'],'auto_fixable':![]};}},R_P_5_02={'id':'R-PASS-14','category':'logic','trigger':'Depended\x20Guard\x20cannot\x20have\x20its\x20own\x20dependencies\x20—\x20restricts\x20complex\x20verification\x20logic','check':a=>{if(!a['has_transitive_relies'])return null;return{'id':'R-PASS-14','level':'LOW','category':'logic','title':'Depended\x20Guard\x20cannot\x20have\x20its\x20own\x20dependencies\x20—\x20restricts\x20complex\x20verification\x20logic','description':'Passport\x27s\x20relies\x20mechanism\x20forbids\x20transitive\x20dependencies:\x20a\x20relied-upon\x20Guard\x20cannot\x20have\x20its\x20own\x20relies.\x20This\x20means\x20\x27A\x20depends\x20on\x20B,\x20B\x20depends\x20on\x20C\x27\x20chain\x20verification\x20cannot\x20be\x20modeled.\x20Complex\x20verification\x20logic\x20must\x20be\x20flattened\x20to\x20single-layer\x20dependencies\x20or\x20split\x20into\x20multiple\x20Passports.','affected_stakeholders':['creator','guard_owner'],'scenario':'Designer\x20attempts\x20to\x20model\x20transitive\x20Guard\x20dependencies','mitigation':'Accept\x20the\x20design\x20constraint.\x20For\x20chain\x20verification,\x20flatten\x20all\x20dependency\x20Guards\x20into\x20a\x20single-layer\x20AND\x20dependency,\x20or\x20use\x20Machine\x20workflows\x20to\x20model\x20multi-stage\x20verification.','evidence':'has_transitive_relies='+a['has_transitive_relies'],'auto_fixable':![]};}},R_P_5_03={'id':'R-PASS-15','category':'operational','trigger':'verify_guard\x20is\x20a\x20native\x20function\x20—\x20verification\x20logic\x20is\x20opaque','check':a=>{if(a['operation_type']!=='verify')return null;return{'id':'R-PASS-15','level':'INFO','category':'operational','title':'verify_guard\x20is\x20a\x20native\x20function\x20—\x20verification\x20logic\x20is\x20opaque','description':'guard::verify_guard(passport,\x20guard,\x20submission,\x20impack)\x20is\x20a\x20native\x20function;\x20its\x20internal\x20implementation\x20is\x20not\x20visible\x20in\x20Move\x20source\x20code.\x20The\x20verification\x20logic\x20(how\x20submission\x20is\x20parsed,\x20how\x20Guard\x20table\x20is\x20matched,\x20how\x20result\x20is\x20returned)\x20is\x20implemented\x20by\x20the\x20Wow\x20runtime.\x20Developers\x20cannot\x20fully\x20understand\x20verification\x20details\x20by\x20reading\x20Move\x20source\x20code.','affected_stakeholders':['creator','guard_owner'],'scenario':'Developer\x20attempts\x20to\x20debug\x20verify()\x20failure','mitigation':'Document\x20native\x20behavior:\x20verify_guard\x20verifies\x20submission\x20item-by-item\x20per\x20Guard.table\x20config;\x20types\x20must\x20match.\x20Returns\x20false\x20on\x20failure\x20(does\x20not\x20abort).\x20To\x20debug,\x20test\x20each\x20Guard\x27s\x20submission\x20individually.','evidence':'guard::verify_guard\x20is\x20native','auto_fixable':![]};}},ALL_RULES=[R_P_1_01,R_P_1_02,R_P_1_03,R_P_2_01,R_P_2_02,R_P_2_03,R_P_3_01,R_P_3_02,R_P_3_03,R_P_4_01,R_P_4_02,R_P_4_03,R_P_5_01,R_P_5_02,R_P_5_03];export const PASSPORT_RISK_VERSION='1.0.0';export function getAllRiskRules(){return[...ALL_RULES];}export function getRiskRulesCount(){return ALL_RULES['length'];}export function getRiskRulesByCategory(a){return ALL_RULES['filter'](b=>b['category']===a);}export function assessPassportRisks(a){const b=[];for(const j of ALL_RULES){const k=j['check'](a);if(k)b['push'](k);}const c={'CRITICAL':0x4,'HIGH':0x3,'MEDIUM':0x2,'LOW':0x1,'INFO':0x0},d=b['length']===0x0?'LOW':b['reduce']((l,m)=>c[m['level']]>c[l]?m['level']:l,'INFO'),e={},f={};for(const l of b){e[l['category']]=(e[l['category']]??0x0)+0x1,f[l['level']]=(f[l['level']]??0x0)+0x1;}const g={};for(const m of b){for(const n of m['affected_stakeholders']){if(!g[n])g[n]=[];g[n]['push'](m['id']+':\x20'+m['mitigation']);}}const h=b['filter'](o=>o['level']==='CRITICAL'&&!o['resolved']),i=b['filter'](o=>(o['level']==='CRITICAL'||o['level']==='HIGH')&&!o['resolved']);return{'summary':'Assessed\x20'+b['length']+'\x20risk(s)\x20across\x20'+Object['keys'](e)['length']+'\x20categories','risks':b,'overall_risk':d,'risks_by_category':e,'risks_by_level':f,'stakeholder_advice':g,'needs_human_review':i['length']>0x0,'blocks_publish':h['length']>0x0};}export{PASSPORT_ERROR_CODES};
|