@ottochain/sdk 2.2.5 → 2.4.0

package/dist/types/apps/governance/state-machines/governance-simple.d.ts

@@ -132,13 +132,8 @@ export declare const govSimpleDef: {
             };
         };
         readonly finalize: {
-            readonly description: "Finalize the voting period";
-            readonly required: readonly ["forCount"];
-            readonly properties: {
-                readonly forCount: {
-                    readonly type: "number";
-                };
-            };
+            readonly description: "Finalize the voting period (for-count derived from recorded ballots)";
+            readonly properties: {};
         };
         readonly file_dispute: {
             readonly description: "File a dispute against a member";
@@ -183,35 +178,46 @@ export declare const govSimpleDef: {
             };
         };
         readonly dissolve: {
-            readonly description: "Dissolve the organization (requires 90% approval)";
-            readonly required: readonly ["approvalCount"];
-            readonly properties: {
-                readonly approvalCount: {
-                    readonly type: "number";
-                };
-            };
+            readonly description: "Dissolve the organization (requires every member to sign this op — verified unanimity)";
+            readonly properties: {};
         };
     };
     readonly states: {
         readonly ACTIVE: {
             readonly id: "ACTIVE";
             readonly isFinal: false;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Active";
+                readonly description: "Governance is idle and ready to accept a proposal";
+                readonly category: "initial";
+            };
         };
         readonly VOTING: {
             readonly id: "VOTING";
             readonly isFinal: false;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Voting";
+                readonly description: "A proposal is open for voting";
+                readonly category: "pending";
+            };
         };
         readonly DISPUTE: {
             readonly id: "DISPUTE";
             readonly isFinal: false;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Dispute";
+                readonly description: "A proposal outcome is being disputed";
+                readonly category: "pending";
+            };
         };
         readonly DISSOLVED: {
             readonly id: "DISSOLVED";
             readonly isFinal: true;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Dissolved";
+                readonly description: "Governance entity dissolved (terminal)";
+                readonly category: "terminal";
+            };
         };
     };
     readonly initialState: "ACTIVE";
@@ -219,19 +225,13 @@ export declare const govSimpleDef: {
         readonly from: "ACTIVE";
         readonly to: "ACTIVE";
         readonly eventName: "add_member";
-        readonly guard: {
-            readonly in: readonly [{
-                readonly var: "event.agent";
-            }, {
-                readonly var: "state.admins";
-            }];
-        };
+        readonly guard: import("../../../schema/guards.js").GuardRule;
         readonly effect: {
             readonly merge: readonly [{
                 readonly var: "state";
             }, {
                 readonly members: {
-                    readonly setKey: readonly [{
+                    readonly set: readonly [{
                         readonly var: "state.members";
                     }, {
                         readonly var: "event.member";
@@ -240,7 +240,7 @@ export declare const govSimpleDef: {
                             readonly var: "event.role";
                         };
                         readonly addedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }];
                 };
@@ -251,19 +251,13 @@ export declare const govSimpleDef: {
         readonly from: "ACTIVE";
         readonly to: "ACTIVE";
         readonly eventName: "remove_member";
-        readonly guard: {
-            readonly in: readonly [{
-                readonly var: "event.agent";
-            }, {
-                readonly var: "state.admins";
-            }];
-        };
+        readonly guard: import("../../../schema/guards.js").GuardRule;
         readonly effect: {
             readonly merge: readonly [{
                 readonly var: "state";
             }, {
                 readonly members: {
-                    readonly deleteKey: readonly [{
+                    readonly unset: readonly [{
                         readonly var: "state.members";
                     }, {
                         readonly var: "event.member";
@@ -276,13 +270,7 @@ export declare const govSimpleDef: {
         readonly from: "ACTIVE";
         readonly to: "VOTING";
         readonly eventName: "propose";
-        readonly guard: {
-            readonly getKey: readonly [{
-                readonly var: "state.members";
-            }, {
-                readonly var: "event.agent";
-            }];
-        };
+        readonly guard: import("../../../schema/guards.js").GuardRule;
         readonly effect: {
             readonly merge: readonly [{
                 readonly var: "state";
@@ -301,11 +289,11 @@ export declare const govSimpleDef: {
                         readonly var: "event.agent";
                     };
                     readonly proposedAt: {
-                        readonly var: "$timestamp";
+                        readonly var: "$ordinal";
                     };
                     readonly deadline: {
                         readonly "+": readonly [{
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         }, {
                             readonly var: "state.votingPeriodMs";
                         }];
@@ -320,15 +308,9 @@ export declare const govSimpleDef: {
         readonly to: "VOTING";
         readonly eventName: "vote";
         readonly guard: {
-            readonly and: readonly [{
-                readonly getKey: readonly [{
-                    readonly var: "state.members";
-                }, {
-                    readonly var: "event.agent";
-                }];
-            }, {
+            readonly and: readonly [import("../../../schema/guards.js").GuardRule, {
                 readonly "!": readonly [{
-                    readonly getKey: readonly [{
+                    readonly has: readonly [{
                         readonly var: "state.votes";
                     }, {
                         readonly var: "event.agent";
@@ -341,7 +323,7 @@ export declare const govSimpleDef: {
                 readonly var: "state";
             }, {
                 readonly votes: {
-                    readonly setKey: readonly [{
+                    readonly set: readonly [{
                         readonly var: "state.votes";
                     }, {
                         readonly var: "event.agent";
@@ -350,7 +332,7 @@ export declare const govSimpleDef: {
                             readonly var: "event.vote";
                         };
                         readonly votedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }];
                 };
@@ -363,12 +345,24 @@ export declare const govSimpleDef: {
         readonly eventName: "finalize";
         readonly guard: {
             readonly ">=": readonly [{
-                readonly var: "event.forCount";
+                readonly length: readonly [{
+                    readonly filter: readonly [{
+                        readonly values: readonly [{
+                            readonly var: "state.votes";
+                        }];
+                    }, {
+                        readonly "===": readonly [{
+                            readonly var: "vote";
+                        }, "for"];
+                    }];
+                }];
             }, {
                 readonly "*": readonly [{
-                    readonly size: {
-                        readonly var: "state.members";
-                    };
+                    readonly length: readonly [{
+                        readonly keys: readonly [{
+                            readonly var: "state.members";
+                        }];
+                    }];
                 }, {
                     readonly var: "state.passingThreshold";
                 }];
@@ -395,7 +389,7 @@ export declare const govSimpleDef: {
                         };
                         readonly outcome: "passed";
                         readonly finalizedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }]];
                 };
@@ -410,12 +404,24 @@ export declare const govSimpleDef: {
         readonly eventName: "finalize";
         readonly guard: {
             readonly "<": readonly [{
-                readonly var: "event.forCount";
+                readonly length: readonly [{
+                    readonly filter: readonly [{
+                        readonly values: readonly [{
+                            readonly var: "state.votes";
+                        }];
+                    }, {
+                        readonly "===": readonly [{
+                            readonly var: "vote";
+                        }, "for"];
+                    }];
+                }];
             }, {
                 readonly "*": readonly [{
-                    readonly size: {
-                        readonly var: "state.members";
-                    };
+                    readonly length: readonly [{
+                        readonly keys: readonly [{
+                            readonly var: "state.members";
+                        }];
+                    }];
                 }, {
                     readonly var: "state.passingThreshold";
                 }];
@@ -435,7 +441,7 @@ export declare const govSimpleDef: {
                         };
                         readonly outcome: "failed";
                         readonly finalizedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }]];
                 };
@@ -448,13 +454,7 @@ export declare const govSimpleDef: {
         readonly from: "ACTIVE";
         readonly to: "DISPUTE";
         readonly eventName: "file_dispute";
-        readonly guard: {
-            readonly getKey: readonly [{
-                readonly var: "state.members";
-            }, {
-                readonly var: "event.agent";
-            }];
-        };
+        readonly guard: import("../../../schema/guards.js").GuardRule;
         readonly effect: {
             readonly merge: readonly [{
                 readonly var: "state";
@@ -473,7 +473,7 @@ export declare const govSimpleDef: {
                         readonly var: "event.claim";
                     };
                     readonly filedAt: {
-                        readonly var: "$timestamp";
+                        readonly var: "$ordinal";
                     };
                     readonly evidence: readonly [];
                 };
@@ -485,21 +485,7 @@ export declare const govSimpleDef: {
         readonly from: "DISPUTE";
         readonly to: "DISPUTE";
         readonly eventName: "submit_evidence";
-        readonly guard: {
-            readonly or: readonly [{
-                readonly "===": readonly [{
-                    readonly var: "event.agent";
-                }, {
-                    readonly var: "state.dispute.plaintiff";
-                }];
-            }, {
-                readonly "===": readonly [{
-                    readonly var: "event.agent";
-                }, {
-                    readonly var: "state.dispute.defendant";
-                }];
-            }];
-        };
+        readonly guard: import("../../../schema/guards.js").GuardRule;
         readonly effect: {
             readonly merge: readonly [{
                 readonly var: "state";
@@ -519,7 +505,7 @@ export declare const govSimpleDef: {
                                     readonly var: "event.content";
                                 };
                                 readonly at: {
-                                    readonly var: "$timestamp";
+                                    readonly var: "$ordinal";
                                 };
                             }]];
                         };
@@ -533,27 +519,9 @@ export declare const govSimpleDef: {
         readonly to: "DISPUTE";
         readonly eventName: "vote";
         readonly guard: {
-            readonly and: readonly [{
-                readonly getKey: readonly [{
-                    readonly var: "state.members";
-                }, {
-                    readonly var: "event.agent";
-                }];
-            }, {
-                readonly "!==": readonly [{
-                    readonly var: "event.agent";
-                }, {
-                    readonly var: "state.dispute.plaintiff";
-                }];
-            }, {
-                readonly "!==": readonly [{
-                    readonly var: "event.agent";
-                }, {
-                    readonly var: "state.dispute.defendant";
-                }];
-            }, {
+            readonly and: readonly [import("../../../schema/guards.js").GuardRule, import("../../../schema/guards.js").GuardRule, import("../../../schema/guards.js").GuardRule, {
                 readonly "!": readonly [{
-                    readonly getKey: readonly [{
+                    readonly has: readonly [{
                         readonly var: "state.votes";
                     }, {
                         readonly var: "event.agent";
@@ -566,7 +534,7 @@ export declare const govSimpleDef: {
                 readonly var: "state";
             }, {
                 readonly votes: {
-                    readonly setKey: readonly [{
+                    readonly set: readonly [{
                         readonly var: "state.votes";
                     }, {
                         readonly var: "event.agent";
@@ -575,7 +543,7 @@ export declare const govSimpleDef: {
                             readonly var: "event.ruling";
                         };
                         readonly votedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }];
                 };
@@ -588,9 +556,11 @@ export declare const govSimpleDef: {
         readonly eventName: "resolve";
         readonly guard: {
             readonly ">=": readonly [{
-                readonly size: {
-                    readonly var: "state.votes";
-                };
+                readonly length: readonly [{
+                    readonly keys: readonly [{
+                        readonly var: "state.votes";
+                    }];
+                }];
             }, {
                 readonly var: "state.disputeQuorum";
             }];
@@ -614,7 +584,7 @@ export declare const govSimpleDef: {
                             readonly var: "event.remedy";
                         };
                         readonly resolvedAt: {
-                            readonly var: "$timestamp";
+                            readonly var: "$ordinal";
                         };
                     }]];
                 };
@@ -628,14 +598,30 @@ export declare const govSimpleDef: {
         readonly to: "DISSOLVED";
         readonly eventName: "dissolve";
         readonly guard: {
-            readonly ">=": readonly [{
-                readonly var: "event.approvalCount";
+            readonly and: readonly [{
+                readonly ">": readonly [{
+                    readonly length: readonly [{
+                        readonly keys: readonly [{
+                            readonly var: "state.members";
+                        }];
+                    }];
+                }, 0];
             }, {
-                readonly "*": readonly [{
-                    readonly size: {
+                readonly all: readonly [{
+                    readonly keys: readonly [{
                         readonly var: "state.members";
-                    };
-                }, 0.9];
+                    }];
+                }, {
+                    readonly in: readonly [{
+                        readonly var: "";
+                    }, {
+                        readonly map: readonly [{
+                            readonly var: "proofs";
+                        }, {
+                            readonly var: "address";
+                        }];
+                    }];
+                }];
             }];
         };
         readonly effect: {
@@ -643,7 +629,7 @@ export declare const govSimpleDef: {
                 readonly var: "state";
             }, {
                 readonly dissolvedAt: {
-                    readonly var: "$timestamp";
+                    readonly var: "$ordinal";
                 };
             }];
         };

package/dist/types/apps/governance/state-machines/governance-universal.d.ts

@@ -74,17 +74,29 @@ export declare const govUniversalDef: {
         readonly ACTIVE: {
             readonly id: "ACTIVE";
             readonly isFinal: false;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Active";
+                readonly description: "Governance is idle and ready to accept a proposal";
+                readonly category: "initial";
+            };
         };
         readonly VOTING: {
             readonly id: "VOTING";
             readonly isFinal: false;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Voting";
+                readonly description: "A proposal is open for voting";
+                readonly category: "pending";
+            };
         };
         readonly DISSOLVED: {
             readonly id: "DISSOLVED";
             readonly isFinal: true;
-            readonly metadata: null;
+            readonly metadata: {
+                readonly label: "Dissolved";
+                readonly description: "Governance entity dissolved (terminal)";
+                readonly category: "terminal";
+            };
         };
     };
     readonly initialState: "ACTIVE";
@@ -104,7 +116,7 @@ export declare const govUniversalDef: {
                     readonly var: "event.proposal";
                 };
                 readonly proposedAt: {
-                    readonly var: "$timestamp";
+                    readonly var: "$ordinal";
                 };
                 readonly votes: {};
             }];
@@ -172,7 +184,7 @@ export declare const govUniversalDef: {
             }, {
                 readonly status: "DISSOLVED";
                 readonly dissolvedAt: {
-                    readonly var: "$timestamp";
+                    readonly var: "$ordinal";
                 };
             }];
         };

package/dist/types/apps/identity/constants.d.ts

@@ -5,24 +5,52 @@
  *
  * @packageDocumentation
  */
-import { IdentityState } from "../../generated/ottochain/apps/identity/v1/identity.js";
+import { State } from "../../generated/ottochain/apps/identity/v1/identity.js";
 import { AttestationType } from "../../generated/ottochain/apps/identity/v1/attestation.js";
 /**
  * Valid transitions for each identity state.
  * Maps current state to allowed event names.
  * Note: Some transitions are type-specific (agent vs oracle)
  */
-export declare const IDENTITY_TRANSITIONS: Record<IdentityState, readonly string[]>;
-export declare const AGENT_TRANSITIONS: Record<IdentityState, readonly string[]>;
+export declare const IDENTITY_TRANSITIONS: Record<State, readonly string[]>;
+export declare const AGENT_TRANSITIONS: Record<State, readonly string[]>;
 /**
  * Reputation delta by attestation type.
  * These values match the metagraph state machine defaults.
  */
 export declare const ATTESTATION_DELTAS: Record<AttestationType, number>;
+/**
+ * Role-attestation types issued by the identity registry (identity-registry fiber).
+ * These are the ecosystem-wide authority roles consumer apps gate on via the registry
+ * dependency + `signerHasRole` (see docs/design/app-hardening-identity-integration.md §4.2).
+ */
+export declare const REGISTRY_ROLES: {
+    readonly ARBITER: "ARBITER";
+    readonly SLASHER: "SLASHER";
+    readonly ISSUER: "ISSUER";
+    readonly BOARD_MEMBER: "BOARD_MEMBER";
+};
+export type RegistryRole = keyof typeof REGISTRY_ROLES;
+/**
+ * Maps each role to the registry's flat per-role state-map field. A consumer app reads
+ * `machines.<registryDep>.state.<field>` (a `{ <address>: true }` map) and binds membership to a
+ * verified signer with `signerHasRole`. Kept in lock-step with the identity-registry stateSchema.
+ */
+export declare const REGISTRY_ROLE_MAP: Record<RegistryRole, string>;
+/**
+ * Build the `machines.<registryDep>.state.<roleMap>` var path a consumer guard reads to check a role,
+ * e.g. `registryRolePath("reg-uuid", "ARBITER")` → `"machines.reg-uuid.state.arbiters"`.
+ */
+export declare function registryRolePath(registryDep: string, role: RegistryRole): string;
+/**
+ * Build the `machines.<registryDep>.state.reputations` var path a consumer guard reads for a
+ * reputation gate (`signerHasReputation`).
+ */
+export declare function registryReputationPath(registryDep: string): string;
 /**
  * Check if a transition is valid for the given state.
  */
-export declare function canTransition(state: IdentityState, event: string): boolean;
+export declare function canTransition(state: State, event: string): boolean;
 /**
  * Get reputation delta for an attestation type.
  */