@ottochain/sdk 1.7.0-beta.2 → 2.1.0

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

@@ -1,32 +1,42 @@
 /**
  * Identity Constants
  *
- * State machine transitions and configuration constants for identities.
+ * State machine transitions and configuration constants for identity types.
  *
  * @packageDocumentation
  */
-import { IdentityState, IdentityType } from '../../generated/ottochain/apps/identity/v1/identity.js';
-import { AttestationType } from '../../generated/ottochain/apps/identity/v1/attestation.js';
+import { IdentityState } from "../../generated/ottochain/apps/identity/v1/identity.js";
+import { AttestationType } from "../../generated/ottochain/apps/identity/v1/attestation.js";
 // ---------------------------------------------------------------------------
 // State Machine Transitions
 // ---------------------------------------------------------------------------
 /**
  * Valid transitions for each identity state.
  * Maps current state to allowed event names.
+ * 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', 'deactivate', 'withdraw', 'penalize'],
-    [IdentityState.IDENTITY_STATE_INACTIVE]: ['activate', 'withdraw'],
-    [IdentityState.IDENTITY_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
-    [IdentityState.IDENTITY_STATE_SUSPENDED]: ['begin_probation', 'withdraw'],
-    [IdentityState.IDENTITY_STATE_PROBATION]: ['complete_probation'],
+    [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]: [],
 };
-// Legacy alias for backward compatibility
+// Legacy alias
 export const AGENT_TRANSITIONS = IDENTITY_TRANSITIONS;
 // ---------------------------------------------------------------------------
 // Reputation Configuration
@@ -55,13 +65,3 @@ export function canTransition(state, event) {
 export function getReputationDelta(type) {
     return ATTESTATION_DELTAS[type] ?? 0;
 }
-/**
- * Identity type display names
- */
-export const IDENTITY_TYPE_NAMES = {
-    [IdentityType.IDENTITY_TYPE_UNSPECIFIED]: 'Unknown',
-    [IdentityType.IDENTITY_TYPE_AGENT]: 'Agent',
-    [IdentityType.IDENTITY_TYPE_ORACLE]: 'Oracle',
-    [IdentityType.IDENTITY_TYPE_SERVICE]: 'Service',
-    [IdentityType.UNRECOGNIZED]: 'Unknown',
-};

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

@@ -1,33 +1,33 @@
 /**
- * Identity Application
+ * Agent Identity Application
  *
- * Types and utilities for the Identity system on OttoChain.
- * Includes agents, oracles, and services.
+ * Types and utilities for the Agent Identity system on OttoChain.
  *
  * @example
  * ```typescript
  * import {
- *   IdentityState,
- *   IdentityType,
+ *   AgentState,
+ *   AgentIdentity,
  *   getIdentityDefinition
  * } from '@ottochain/sdk/apps/identity';
  *
- * const oracleDef = getIdentityDefinition('oracle');
+ * const identityDef = getIdentityDefinition();
  * ```
  *
  * @packageDocumentation
  */
 // Re-export generated protobuf types (source of truth)
-export { IdentityType, IdentityState, Platform, PlatformLink, Reputation, PenaltyEvent, Identity, RegisterIdentityRequest, ActivateIdentityRequest, UpdateStakeRequest, ChallengeIdentityRequest, PenalizeIdentityRequest, WithdrawIdentityRequest, IdentityDefinition, identityTypeFromJSON, identityTypeToJSON, identityStateFromJSON, identityStateToJSON, platformFromJSON, platformToJSON, } 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 { 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";
+// 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";
 // Re-export constants and utilities
-export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, // Legacy alias
-ATTESTATION_DELTAS, IDENTITY_TYPE_NAMES, canTransition, getReputationDelta, } from './constants.js';
+export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from "./constants.js";
 // ---------------------------------------------------------------------------
 // Configuration Defaults
 // ---------------------------------------------------------------------------
 /**
- * Default reputation configuration for identities
+ * Default reputation configuration for agent identity
  */
 export const DEFAULT_REPUTATION_CONFIG = {
     baseReputation: 10,
@@ -38,19 +38,10 @@ export const DEFAULT_REPUTATION_CONFIG = {
     minReputation: 0,
     challengeThreshold: 5,
 };
-/**
- * Default oracle configuration
- */
-export const DEFAULT_ORACLE_CONFIG = {
-    minStake: 100,
-    slashCooldownEpochs: 7,
-    accuracyThreshold: 70,
-    maxDisputeRate: 30,
-};
 // ---------------------------------------------------------------------------
 // State Machine Definitions (generated from JSON at build time)
 // ---------------------------------------------------------------------------
-import { identityUniversalDef, identityAgentDef, identityOracleDef, } from './state-machines/index.js';
+import { identityUniversalDef, identityAgentDef, identityOracleDef, } from "./state-machines/index.js";
 export { identityUniversalDef, identityAgentDef, identityOracleDef };
 /** All identity state machine definitions */
 export const IDENTITY_DEFINITIONS = {
@@ -62,6 +53,6 @@ export const IDENTITY_DEFINITIONS = {
  * Get an identity state machine definition by type.
  * @param type - 'universal' | 'agent' | 'oracle' (default: 'agent')
  */
-export function getIdentityDefinition(type = 'agent') {
+export function getIdentityDefinition(type = "agent") {
     return IDENTITY_DEFINITIONS[type];
 }

package/dist/esm/apps/identity/state-machines/identity-agent.js

@@ -0,0 +1,253 @@
+import { defineFiberApp } from "../../../schema/fiber-app.js";
+/**
+ * Standard agent identity with reputation tracking, vouching, and lifecycle management.
+ */
+export const identityAgentDef = defineFiberApp({
+    metadata: {
+        name: "IdentityAgent",
+        app: "identity",
+        type: "agent",
+        version: "1.0.0",
+        description: "Standard agent identity with reputation tracking, vouching, and lifecycle management",
+    },
+    createSchema: {
+        required: ["owner", "displayName"],
+        properties: {
+            owner: {
+                type: "address",
+                description: "Agent owner DAG address",
+                immutable: true,
+            },
+            displayName: {
+                type: "string",
+                maxLength: 64,
+                description: "Human-readable agent name",
+            },
+            bio: {
+                type: "string",
+                maxLength: 256,
+                default: "",
+            },
+            avatar: {
+                type: "uri",
+                default: null,
+            },
+            platforms: {
+                type: "array",
+                items: { $ref: "#/definitions/PlatformLink" },
+                default: [],
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            owner: { type: "address", immutable: true },
+            displayName: { type: "string" },
+            bio: { type: "string" },
+            avatar: { type: "uri" },
+            platforms: {
+                type: "array",
+                items: { $ref: "#/definitions/PlatformLink" },
+            },
+            status: {
+                type: "string",
+                enum: [
+                    "REGISTERED",
+                    "ACTIVE",
+                    "CHALLENGED",
+                    "SUSPENDED",
+                    "PROBATION",
+                    "WITHDRAWN",
+                ],
+                computed: true,
+            },
+            reputation: { type: "integer", default: 10, computed: true },
+            activatedAt: { type: "timestamp", computed: true },
+            suspendedAt: { type: "timestamp", computed: true },
+            probationStartedAt: { type: "timestamp", computed: true },
+            challengedBy: { type: "address", computed: true },
+        },
+    },
+    eventSchemas: {
+        activate: {
+            description: "Activate a registered agent",
+        },
+        receive_vouch: {
+            description: "Receive a vouch from another agent",
+            required: ["from"],
+            properties: {
+                from: { type: "address", description: "Address of vouching agent" },
+                weight: { type: "integer", minimum: 1, maximum: 10, default: 1 },
+            },
+        },
+        receive_completion: {
+            description: "Receive completion attestation from a fiber",
+        },
+        challenge: {
+            description: "Challenge an active agent's behavior",
+            required: ["challenger", "reason"],
+            properties: {
+                challenger: { type: "address" },
+                reason: { type: "string", maxLength: 512 },
+                evidence: { type: "array", items: { type: "uri" } },
+            },
+        },
+        dismiss_challenge: {
+            description: "Dismiss an active challenge",
+        },
+        uphold_challenge: {
+            description: "Uphold a challenge, suspending the agent",
+        },
+        begin_probation: {
+            description: "Move suspended agent to probation",
+        },
+        complete_probation: {
+            description: "Complete probation, reactivating the agent",
+        },
+        withdraw: {
+            description: "Permanently withdraw the agent",
+        },
+    },
+    definitions: {
+        PlatformLink: {
+            type: "object",
+            required: ["platform", "handle"],
+            properties: {
+                platform: {
+                    type: "string",
+                    enum: [
+                        "twitter",
+                        "github",
+                        "discord",
+                        "telegram",
+                        "moltbook",
+                    ],
+                },
+                handle: { type: "string" },
+                verified: { type: "boolean", default: false },
+            },
+        },
+    },
+    states: {
+        REGISTERED: { id: "REGISTERED", isFinal: false },
+        ACTIVE: { id: "ACTIVE", isFinal: false },
+        CHALLENGED: { id: "CHALLENGED", isFinal: false },
+        SUSPENDED: { id: "SUSPENDED", isFinal: false },
+        PROBATION: { id: "PROBATION", isFinal: false },
+        WITHDRAWN: { id: "WITHDRAWN", isFinal: true },
+    },
+    initialState: "REGISTERED",
+    transitions: [
+        {
+            from: "REGISTERED",
+            to: "ACTIVE",
+            eventName: "activate",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", activatedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "receive_vouch",
+            guard: { "!!": [{ var: "event.from" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { reputation: { "+": [{ var: "state.reputation" }, 2] } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "receive_completion",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { reputation: { "+": [{ var: "state.reputation" }, 5] } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "CHALLENGED",
+            eventName: "challenge",
+            guard: { "!!": [{ var: "event.challenger" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CHALLENGED", challengedBy: { var: "event.challenger" } },
+                ],
+            },
+        },
+        {
+            from: "CHALLENGED",
+            to: "ACTIVE",
+            eventName: "dismiss_challenge",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "ACTIVE", challengedBy: null }],
+            },
+        },
+        {
+            from: "CHALLENGED",
+            to: "SUSPENDED",
+            eventName: "uphold_challenge",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "SUSPENDED", suspendedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "SUSPENDED",
+            to: "PROBATION",
+            eventName: "begin_probation",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "PROBATION", probationStartedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "PROBATION",
+            to: "ACTIVE",
+            eventName: "complete_probation",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", probationStartedAt: null },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "WITHDRAWN" }],
+            },
+        },
+        {
+            from: "REGISTERED",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "WITHDRAWN" }],
+            },
+        },
+    ],
+});