@ottochain/sdk 2.3.0 → 2.5.0

package/dist/esm/apps/governance/state-machines/governance-universal.js

@@ -1,96 +1,96 @@
-import { defineFiberApp } from "../../../schema/fiber-app.js";
+import { defineFiberApp } from '../../../schema/fiber-app.js';
 /**
  * Minimal governance state machine - extend for custom use cases.
  */
 export const govUniversalDef = defineFiberApp({
     metadata: {
-        name: "GovernanceUniversal",
-        app: "governance",
-        type: "universal",
-        version: "1.0.0",
-        description: "Minimal governance state machine - extend for custom use cases",
+        name: 'GovernanceUniversal',
+        app: 'governance',
+        type: 'universal',
+        version: '1.0.0',
+        description: 'Minimal governance state machine - extend for custom use cases',
     },
     createSchema: {
         properties: {},
     },
     stateSchema: {
         properties: {
-            status: { type: "string" },
-            proposal: { type: "object" },
-            proposedAt: { type: "timestamp" },
-            votes: { type: "object", computed: true },
-            lastProposal: { type: "object" },
-            lastResult: { type: "string" },
-            dissolvedAt: { type: "timestamp" },
+            status: { type: 'string' },
+            proposal: { type: 'object' },
+            proposedAt: { type: 'timestamp' },
+            votes: { type: 'object', computed: true },
+            lastProposal: { type: 'object' },
+            lastResult: { type: 'string' },
+            dissolvedAt: { type: 'timestamp' },
         },
     },
     eventSchemas: {
         propose: {
-            description: "Submit a new proposal",
+            description: 'Submit a new proposal',
             properties: {
-                proposal: { type: "object" },
+                proposal: { type: 'object' },
             },
         },
         vote: {
-            description: "Cast a vote on the active proposal",
+            description: 'Cast a vote on the active proposal',
             properties: {
-                agent: { type: "address" },
-                vote: { type: "string" },
+                agent: { type: 'address' },
+                vote: { type: 'string' },
             },
         },
         finalize: {
-            description: "Finalize the current proposal",
+            description: 'Finalize the current proposal',
             properties: {
-                result: { type: "string" },
+                result: { type: 'string' },
             },
         },
         dissolve: {
-            description: "Dissolve the governance entity",
+            description: 'Dissolve the governance entity',
         },
     },
     states: {
         ACTIVE: {
-            id: "ACTIVE",
+            id: 'ACTIVE',
             isFinal: false,
             metadata: {
-                label: "Active",
-                description: "Governance is idle and ready to accept a proposal",
-                category: "initial",
+                label: 'Active',
+                description: 'Governance is idle and ready to accept a proposal',
+                category: 'initial',
             },
         },
         VOTING: {
-            id: "VOTING",
+            id: 'VOTING',
             isFinal: false,
             metadata: {
-                label: "Voting",
-                description: "A proposal is open for voting",
-                category: "pending",
+                label: 'Voting',
+                description: 'A proposal is open for voting',
+                category: 'pending',
             },
         },
         DISSOLVED: {
-            id: "DISSOLVED",
+            id: 'DISSOLVED',
             isFinal: true,
             metadata: {
-                label: "Dissolved",
-                description: "Governance entity dissolved (terminal)",
-                category: "terminal",
+                label: 'Dissolved',
+                description: 'Governance entity dissolved (terminal)',
+                category: 'terminal',
             },
         },
     },
-    initialState: "ACTIVE",
+    initialState: 'ACTIVE',
     transitions: [
         {
-            from: "ACTIVE",
-            to: "VOTING",
-            eventName: "propose",
-            guard: { "==": [1, 1] },
+            from: 'ACTIVE',
+            to: 'VOTING',
+            eventName: 'propose',
+            guard: { '==': [1, 1] },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "VOTING",
-                        proposal: { var: "event.proposal" },
-                        proposedAt: { var: "$timestamp" },
+                        status: 'VOTING',
+                        proposal: { var: 'event.proposal' },
+                        proposedAt: { var: '$ordinal' },
                         votes: {},
                     },
                 ],
@@ -98,20 +98,20 @@ export const govUniversalDef = defineFiberApp({
             dependencies: [],
         },
         {
-            from: "VOTING",
-            to: "VOTING",
-            eventName: "vote",
-            guard: { "==": [1, 1] },
+            from: 'VOTING',
+            to: 'VOTING',
+            eventName: 'vote',
+            guard: { '==': [1, 1] },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
                         votes: {
                             merge: [
-                                { var: "state.votes" },
+                                { var: 'state.votes' },
                                 {
-                                    __key: { var: "event.agent" },
-                                    __value: { var: "event.vote" },
+                                    __key: { var: 'event.agent' },
+                                    __value: { var: 'event.vote' },
                                 },
                             ],
                         },
@@ -121,17 +121,17 @@ export const govUniversalDef = defineFiberApp({
             dependencies: [],
         },
         {
-            from: "VOTING",
-            to: "ACTIVE",
-            eventName: "finalize",
-            guard: { "==": [1, 1] },
+            from: 'VOTING',
+            to: 'ACTIVE',
+            eventName: 'finalize',
+            guard: { '==': [1, 1] },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "ACTIVE",
-                        lastProposal: { var: "state.proposal" },
-                        lastResult: { var: "event.result" },
+                        status: 'ACTIVE',
+                        lastProposal: { var: 'state.proposal' },
+                        lastResult: { var: 'event.result' },
                         proposal: null,
                         votes: null,
                     },
@@ -140,16 +140,16 @@ export const govUniversalDef = defineFiberApp({
             dependencies: [],
         },
         {
-            from: "ACTIVE",
-            to: "DISSOLVED",
-            eventName: "dissolve",
-            guard: { "==": [1, 1] },
+            from: 'ACTIVE',
+            to: 'DISSOLVED',
+            eventName: 'dissolve',
+            guard: { '==': [1, 1] },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "DISSOLVED",
-                        dissolvedAt: { var: "$timestamp" },
+                        status: 'DISSOLVED',
+                        dissolvedAt: { var: '$ordinal' },
                     },
                 ],
             },

package/dist/esm/apps/identity/constants.js

@@ -5,8 +5,8 @@
  *
  * @packageDocumentation
  */
-import { IdentityState } from "../../generated/ottochain/apps/identity/v1/identity.js";
-import { AttestationType } from "../../generated/ottochain/apps/identity/v1/attestation.js";
+import { State } from '../../generated/ottochain/apps/identity/v1/identity.js';
+import { AttestationType } from '../../generated/ottochain/apps/identity/v1/attestation.js';
 // ---------------------------------------------------------------------------
 // State Machine Transitions
 // ---------------------------------------------------------------------------
@@ -16,25 +16,17 @@ import { AttestationType } from "../../generated/ottochain/apps/identity/v1/atte
  * Note: Some transitions are type-specific (agent vs oracle)
  */
 export const IDENTITY_TRANSITIONS = {
-    [IdentityState.IDENTITY_STATE_UNSPECIFIED]: [],
-    [IdentityState.IDENTITY_STATE_UNREGISTERED]: ["register"],
-    [IdentityState.IDENTITY_STATE_REGISTERED]: ["activate", "withdraw"],
-    [IdentityState.IDENTITY_STATE_ACTIVE]: [
-        "challenge",
-        "slash",
-        "deactivate",
-        "withdraw",
-    ],
-    [IdentityState.IDENTITY_STATE_CHALLENGED]: [
-        "uphold_challenge",
-        "dismiss_challenge",
-    ],
-    [IdentityState.IDENTITY_STATE_SUSPENDED]: ["begin_probation"],
-    [IdentityState.IDENTITY_STATE_PROBATION]: ["complete_probation"],
-    [IdentityState.IDENTITY_STATE_SLASHED]: ["reactivate", "withdraw"],
-    [IdentityState.IDENTITY_STATE_INACTIVE]: ["activate", "withdraw"],
-    [IdentityState.IDENTITY_STATE_WITHDRAWN]: [], // Terminal state
-    [IdentityState.UNRECOGNIZED]: [],
+    [State.IDENTITY_STATE_UNSPECIFIED]: [],
+    [State.IDENTITY_STATE_UNREGISTERED]: ['register'],
+    [State.IDENTITY_STATE_REGISTERED]: ['activate', 'withdraw'],
+    [State.IDENTITY_STATE_ACTIVE]: ['challenge', 'slash', 'deactivate', 'withdraw'],
+    [State.IDENTITY_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
+    [State.IDENTITY_STATE_SUSPENDED]: ['begin_probation'],
+    [State.IDENTITY_STATE_PROBATION]: ['complete_probation'],
+    [State.IDENTITY_STATE_SLASHED]: ['reactivate', 'withdraw'],
+    [State.IDENTITY_STATE_INACTIVE]: ['activate', 'withdraw'],
+    [State.IDENTITY_STATE_WITHDRAWN]: [], // Terminal state
+    [State.UNRECOGNIZED]: [],
 };
 // Legacy alias
 export const AGENT_TRANSITIONS = IDENTITY_TRANSITIONS;
@@ -53,6 +45,45 @@ export const ATTESTATION_DELTAS = {
     [AttestationType.ATTESTATION_TYPE_BEHAVIORAL]: 3,
     [AttestationType.UNRECOGNIZED]: 0,
 };
+// ---------------------------------------------------------------------------
+// Identity Registry — role attestations
+// ---------------------------------------------------------------------------
+/**
+ * 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 const REGISTRY_ROLES = {
+    ARBITER: 'ARBITER',
+    SLASHER: 'SLASHER',
+    ISSUER: 'ISSUER',
+    BOARD_MEMBER: 'BOARD_MEMBER',
+};
+/**
+ * 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 const REGISTRY_ROLE_MAP = {
+    ARBITER: 'arbiters',
+    SLASHER: 'slashers',
+    ISSUER: 'issuers',
+    BOARD_MEMBER: 'boardMembers',
+};
+/**
+ * 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 function registryRolePath(registryDep, role) {
+    return `machines.${registryDep}.state.${REGISTRY_ROLE_MAP[role]}`;
+}
+/**
+ * Build the `machines.<registryDep>.state.reputations` var path a consumer guard reads for a
+ * reputation gate (`signerHasReputation`).
+ */
+export function registryReputationPath(registryDep) {
+    return `machines.${registryDep}.state.reputations`;
+}
 /**
  * Check if a transition is valid for the given state.
  */

package/dist/esm/apps/identity/index.js

@@ -16,13 +16,17 @@
  *
  * @packageDocumentation
  */
-// Re-export generated protobuf types (source of truth)
-export { IdentityType, IdentityState, Platform, PlatformLink, Reputation, PenaltyEvent, Identity, RegisterIdentityRequest, ActivateIdentityRequest, LinkPlatformRequest, ChallengeIdentityRequest, AddStakeRequest, WithdrawIdentityRequest, IdentityDefinition, identityTypeFromJSON, identityTypeToJSON, identityStateFromJSON, identityStateToJSON, platformFromJSON, platformToJSON, } from "../../generated/ottochain/apps/identity/v1/identity.js";
+// Re-export generated protobuf types (source of truth).
+// The nested lifecycle/kind enums dropped their app prefix in the proto; under
+// this app-scoped entrypoint they are unambiguously Type / State.
+export { Type, State, Platform, PlatformLink, Reputation, PenaltyEvent, Identity, RegisterIdentityRequest, ActivateIdentityRequest, LinkPlatformRequest, ChallengeIdentityRequest, AddStakeRequest, WithdrawIdentityRequest, IdentityDefinition, typeFromJSON, typeToJSON, stateFromJSON, stateToJSON, platformFromJSON, platformToJSON, } from '../../generated/ottochain/apps/identity/v1/identity.js';
 // Legacy aliases for backward compatibility
-export { IdentityState as AgentState } from "../../generated/ottochain/apps/identity/v1/identity.js";
-export { AttestationType, ReputationDelta, Attestation, VouchRequest, ChallengeRequest, ReputationConfig, attestationTypeFromJSON, attestationTypeToJSON, } from "../../generated/ottochain/apps/identity/v1/attestation.js";
+export { State as AgentState } from '../../generated/ottochain/apps/identity/v1/identity.js';
+// Deprecated app-prefixed aliases (renamed to Type / State); kept for compat.
+export { Type as IdentityType, State as IdentityState, typeFromJSON as identityTypeFromJSON, typeToJSON as identityTypeToJSON, stateFromJSON as identityStateFromJSON, stateToJSON as identityStateToJSON, } from '../../generated/ottochain/apps/identity/v1/identity.js';
+export { AttestationType, ReputationDelta, Attestation, VouchRequest, ChallengeRequest, ReputationConfig, attestationTypeFromJSON, attestationTypeToJSON, } from '../../generated/ottochain/apps/identity/v1/attestation.js';
 // Re-export constants and utilities
-export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from "./constants.js";
+export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, ATTESTATION_DELTAS, REGISTRY_ROLES, REGISTRY_ROLE_MAP, registryRolePath, registryReputationPath, canTransition, getReputationDelta, } from './constants.js';
 // ---------------------------------------------------------------------------
 // Configuration Defaults
 // ---------------------------------------------------------------------------
@@ -41,18 +45,19 @@ export const DEFAULT_REPUTATION_CONFIG = {
 // ---------------------------------------------------------------------------
 // State Machine Definitions (generated from JSON at build time)
 // ---------------------------------------------------------------------------
-import { identityUniversalDef, identityAgentDef, identityOracleDef, } from "./state-machines/index.js";
-export { identityUniversalDef, identityAgentDef, identityOracleDef };
+import { identityUniversalDef, identityAgentDef, identityOracleDef, identityRegistryDef, } from './state-machines/index.js';
+export { identityUniversalDef, identityAgentDef, identityOracleDef, identityRegistryDef };
 /** All identity state machine definitions */
 export const IDENTITY_DEFINITIONS = {
     universal: identityUniversalDef,
     agent: identityAgentDef,
     oracle: identityOracleDef,
+    registry: identityRegistryDef,
 };
 /**
  * Get an identity state machine definition by type.
- * @param type - 'universal' | 'agent' | 'oracle' (default: 'agent')
+ * @param type - 'universal' | 'agent' | 'oracle' | 'registry' (default: 'agent')
  */
-export function getIdentityDefinition(type = "agent") {
+export function getIdentityDefinition(type = 'agent') {
     return IDENTITY_DEFINITIONS[type];
 }