Skip to content

Commit d825e8b

Browse files
Add Phase C3 transition authorization matrix (documentation only)
1 parent fc89529 commit d825e8b

File tree

1 file changed

+137
-0
lines changed

1 file changed

+137
-0
lines changed

PHASE-C3-TRANSITIONS.mdmd

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# Phase C3 — Transition Authorization Matrix
2+
3+
This document defines authorization and validation requirements
4+
for all state transitions defined in Phase C1.
5+
6+
No new states or transitions are introduced here.
7+
This file assigns authority and conditions only.
8+
9+
---
10+
11+
## Transition: Created → ReceiverConfirmed
12+
13+
**Authority:** Receiver
14+
15+
**Required Conditions:**
16+
- Intent exists
17+
- Intent is in Created state
18+
- Receiver identity matches intent.receiver
19+
20+
**Proof Required:**
21+
- Receiver acknowledgment proof (abstract)
22+
23+
**Failure Outcome:**
24+
- If invalid or missing proof: remain in Created
25+
- If expired: transition handled by expiry rule
26+
27+
---
28+
29+
## Transition: Created → Invalid
30+
31+
**Authority:** Protocol
32+
33+
**Required Conditions:**
34+
- Intent detected as malformed OR
35+
- Intent parameters violate protocol invariants
36+
37+
**Proof Required:**
38+
- None
39+
40+
**Failure Outcome:**
41+
- Terminal Invalid state
42+
- Refund path preserved
43+
44+
---
45+
46+
## Transition: ReceiverConfirmed → Committed
47+
48+
**Authority:** Sender
49+
50+
**Required Conditions:**
51+
- ReceiverConfirmed state
52+
- Sender identity matches intent.sender
53+
- Intent parameters unchanged
54+
55+
**Proof Required:**
56+
- Sender commitment proof (abstract)
57+
58+
**Failure Outcome:**
59+
- If proof invalid: remain ReceiverConfirmed
60+
- If expired: transition handled by expiry rule
61+
62+
---
63+
64+
## Transition: ReceiverConfirmed → Invalid
65+
66+
**Authority:** Protocol
67+
68+
**Required Conditions:**
69+
- Proof contradiction detected
70+
- Timeout exceeded without sender action
71+
72+
**Proof Required:**
73+
- None
74+
75+
**Failure Outcome:**
76+
- Terminal Invalid state
77+
- Refund path preserved
78+
79+
---
80+
81+
## Transition: Committed → Completed
82+
83+
**Authority:** Protocol
84+
85+
**Required Conditions:**
86+
- Valid settlement condition satisfied
87+
- No conflicting proofs exist
88+
89+
**Proof Required:**
90+
- Settlement fulfillment proof (abstract)
91+
92+
**Failure Outcome:**
93+
- If settlement fails: remain Committed
94+
- If expiry reached: refund path applies
95+
96+
---
97+
98+
## Transition: Committed → Invalid
99+
100+
**Authority:** Protocol
101+
102+
**Required Conditions:**
103+
- Invalid or contradictory settlement proof
104+
- Detected tampering
105+
106+
**Proof Required:**
107+
- None
108+
109+
**Failure Outcome:**
110+
- Terminal Invalid state
111+
- Refund path preserved
112+
113+
---
114+
115+
## Expiry Rule (Global)
116+
117+
**Authority:** Protocol
118+
119+
**Applies To States:**
120+
- Created
121+
- ReceiverConfirmed
122+
- Committed
123+
124+
**Condition:**
125+
- Intent expiry time reached without completion
126+
127+
**Outcome:**
128+
- Refund to sender
129+
- Terminal state reached
130+
131+
---
132+
133+
## Notes
134+
135+
- No transition may be initiated without declared authority.
136+
- No proof format is defined at this phase.
137+
- All terminal states are immutable.

0 commit comments

Comments
 (0)