@ottochain/sdk 1.7.0-beta.2 → 2.1.0

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

@@ -2,12 +2,12 @@
 /**
  * Identity Constants
  *
- * State machine transitions and configuration constants for identities.
+ * State machine transitions and configuration constants for identity types.
  *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDENTITY_TYPE_NAMES = exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = void 0;
+exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = void 0;
 const identity_js_1 = require("../../generated/ottochain/apps/identity/v1/identity.js");
 const attestation_js_1 = require("../../generated/ottochain/apps/identity/v1/attestation.js");
 // ---------------------------------------------------------------------------
@@ -16,20 +16,30 @@ const attestation_js_1 = require("../../generated/ottochain/apps/identity/v1/att
 /**
  * Valid transitions for each identity state.
  * Maps current state to allowed event names.
+ * Note: Some transitions are type-specific (agent vs oracle)
  */
 exports.IDENTITY_TRANSITIONS = {
     [identity_js_1.IdentityState.IDENTITY_STATE_UNSPECIFIED]: [],
-    [identity_js_1.IdentityState.IDENTITY_STATE_UNREGISTERED]: ['register'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_REGISTERED]: ['activate', 'withdraw'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_ACTIVE]: ['challenge', 'deactivate', 'withdraw', 'penalize'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_INACTIVE]: ['activate', 'withdraw'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_SUSPENDED]: ['begin_probation', 'withdraw'],
-    [identity_js_1.IdentityState.IDENTITY_STATE_PROBATION]: ['complete_probation'],
+    [identity_js_1.IdentityState.IDENTITY_STATE_UNREGISTERED]: ["register"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_REGISTERED]: ["activate", "withdraw"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_ACTIVE]: [
+        "challenge",
+        "slash",
+        "deactivate",
+        "withdraw",
+    ],
+    [identity_js_1.IdentityState.IDENTITY_STATE_CHALLENGED]: [
+        "uphold_challenge",
+        "dismiss_challenge",
+    ],
+    [identity_js_1.IdentityState.IDENTITY_STATE_SUSPENDED]: ["begin_probation"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_PROBATION]: ["complete_probation"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_SLASHED]: ["reactivate", "withdraw"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_INACTIVE]: ["activate", "withdraw"],
     [identity_js_1.IdentityState.IDENTITY_STATE_WITHDRAWN]: [], // Terminal state
     [identity_js_1.IdentityState.UNRECOGNIZED]: [],
 };
-// Legacy alias for backward compatibility
+// Legacy alias
 exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS;
 // ---------------------------------------------------------------------------
 // Reputation Configuration
@@ -60,13 +70,3 @@ function getReputationDelta(type) {
     return exports.ATTESTATION_DELTAS[type] ?? 0;
 }
 exports.getReputationDelta = getReputationDelta;
-/**
- * Identity type display names
- */
-exports.IDENTITY_TYPE_NAMES = {
-    [identity_js_1.IdentityType.IDENTITY_TYPE_UNSPECIFIED]: 'Unknown',
-    [identity_js_1.IdentityType.IDENTITY_TYPE_AGENT]: 'Agent',
-    [identity_js_1.IdentityType.IDENTITY_TYPE_ORACLE]: 'Oracle',
-    [identity_js_1.IdentityType.IDENTITY_TYPE_SERVICE]: 'Service',
-    [identity_js_1.IdentityType.UNRECOGNIZED]: 'Unknown',
-};

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

@@ -1,25 +1,24 @@
 "use strict";
 /**
- * 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
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIdentityDefinition = exports.IDENTITY_DEFINITIONS = exports.identityOracleDef = exports.identityAgentDef = exports.identityUniversalDef = exports.DEFAULT_ORACLE_CONFIG = exports.DEFAULT_REPUTATION_CONFIG = exports.getReputationDelta = exports.canTransition = exports.IDENTITY_TYPE_NAMES = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = exports.attestationTypeToJSON = exports.attestationTypeFromJSON = exports.ReputationConfig = exports.ChallengeRequest = exports.VouchRequest = exports.Attestation = exports.ReputationDelta = exports.AttestationType = exports.platformToJSON = exports.platformFromJSON = exports.identityStateToJSON = exports.identityStateFromJSON = exports.identityTypeToJSON = exports.identityTypeFromJSON = exports.IdentityDefinition = exports.WithdrawIdentityRequest = exports.PenalizeIdentityRequest = exports.ChallengeIdentityRequest = exports.UpdateStakeRequest = exports.ActivateIdentityRequest = exports.RegisterIdentityRequest = exports.Identity = exports.PenaltyEvent = exports.Reputation = exports.PlatformLink = exports.Platform = exports.IdentityState = exports.IdentityType = void 0;
+exports.getIdentityDefinition = exports.IDENTITY_DEFINITIONS = exports.identityOracleDef = exports.identityAgentDef = exports.identityUniversalDef = exports.DEFAULT_REPUTATION_CONFIG = exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = exports.attestationTypeToJSON = exports.attestationTypeFromJSON = exports.ReputationConfig = exports.ChallengeRequest = exports.VouchRequest = exports.Attestation = exports.ReputationDelta = exports.AttestationType = exports.AgentState = exports.platformToJSON = exports.platformFromJSON = exports.identityStateToJSON = exports.identityStateFromJSON = exports.identityTypeToJSON = exports.identityTypeFromJSON = exports.IdentityDefinition = exports.WithdrawIdentityRequest = exports.AddStakeRequest = exports.ChallengeIdentityRequest = exports.LinkPlatformRequest = exports.ActivateIdentityRequest = exports.RegisterIdentityRequest = exports.Identity = exports.PenaltyEvent = exports.Reputation = exports.PlatformLink = exports.Platform = exports.IdentityState = exports.IdentityType = void 0;
 // Re-export generated protobuf types (source of truth)
 var identity_js_1 = require("../../generated/ottochain/apps/identity/v1/identity.js");
 Object.defineProperty(exports, "IdentityType", { enumerable: true, get: function () { return identity_js_1.IdentityType; } });
@@ -31,9 +30,9 @@ Object.defineProperty(exports, "PenaltyEvent", { enumerable: true, get: function
 Object.defineProperty(exports, "Identity", { enumerable: true, get: function () { return identity_js_1.Identity; } });
 Object.defineProperty(exports, "RegisterIdentityRequest", { enumerable: true, get: function () { return identity_js_1.RegisterIdentityRequest; } });
 Object.defineProperty(exports, "ActivateIdentityRequest", { enumerable: true, get: function () { return identity_js_1.ActivateIdentityRequest; } });
-Object.defineProperty(exports, "UpdateStakeRequest", { enumerable: true, get: function () { return identity_js_1.UpdateStakeRequest; } });
+Object.defineProperty(exports, "LinkPlatformRequest", { enumerable: true, get: function () { return identity_js_1.LinkPlatformRequest; } });
 Object.defineProperty(exports, "ChallengeIdentityRequest", { enumerable: true, get: function () { return identity_js_1.ChallengeIdentityRequest; } });
-Object.defineProperty(exports, "PenalizeIdentityRequest", { enumerable: true, get: function () { return identity_js_1.PenalizeIdentityRequest; } });
+Object.defineProperty(exports, "AddStakeRequest", { enumerable: true, get: function () { return identity_js_1.AddStakeRequest; } });
 Object.defineProperty(exports, "WithdrawIdentityRequest", { enumerable: true, get: function () { return identity_js_1.WithdrawIdentityRequest; } });
 Object.defineProperty(exports, "IdentityDefinition", { enumerable: true, get: function () { return identity_js_1.IdentityDefinition; } });
 Object.defineProperty(exports, "identityTypeFromJSON", { enumerable: true, get: function () { return identity_js_1.identityTypeFromJSON; } });
@@ -42,6 +41,9 @@ Object.defineProperty(exports, "identityStateFromJSON", { enumerable: true, get:
 Object.defineProperty(exports, "identityStateToJSON", { enumerable: true, get: function () { return identity_js_1.identityStateToJSON; } });
 Object.defineProperty(exports, "platformFromJSON", { enumerable: true, get: function () { return identity_js_1.platformFromJSON; } });
 Object.defineProperty(exports, "platformToJSON", { enumerable: true, get: function () { return identity_js_1.platformToJSON; } });
+// Legacy aliases for backward compatibility
+var identity_js_2 = require("../../generated/ottochain/apps/identity/v1/identity.js");
+Object.defineProperty(exports, "AgentState", { enumerable: true, get: function () { return identity_js_2.IdentityState; } });
 var attestation_js_1 = require("../../generated/ottochain/apps/identity/v1/attestation.js");
 Object.defineProperty(exports, "AttestationType", { enumerable: true, get: function () { return attestation_js_1.AttestationType; } });
 Object.defineProperty(exports, "ReputationDelta", { enumerable: true, get: function () { return attestation_js_1.ReputationDelta; } });
@@ -56,14 +58,13 @@ var constants_js_1 = require("./constants.js");
 Object.defineProperty(exports, "IDENTITY_TRANSITIONS", { enumerable: true, get: function () { return constants_js_1.IDENTITY_TRANSITIONS; } });
 Object.defineProperty(exports, "AGENT_TRANSITIONS", { enumerable: true, get: function () { return constants_js_1.AGENT_TRANSITIONS; } });
 Object.defineProperty(exports, "ATTESTATION_DELTAS", { enumerable: true, get: function () { return constants_js_1.ATTESTATION_DELTAS; } });
-Object.defineProperty(exports, "IDENTITY_TYPE_NAMES", { enumerable: true, get: function () { return constants_js_1.IDENTITY_TYPE_NAMES; } });
 Object.defineProperty(exports, "canTransition", { enumerable: true, get: function () { return constants_js_1.canTransition; } });
 Object.defineProperty(exports, "getReputationDelta", { enumerable: true, get: function () { return constants_js_1.getReputationDelta; } });
 // ---------------------------------------------------------------------------
 // Configuration Defaults
 // ---------------------------------------------------------------------------
 /**
- * Default reputation configuration for identities
+ * Default reputation configuration for agent identity
  */
 exports.DEFAULT_REPUTATION_CONFIG = {
     baseReputation: 10,
@@ -74,15 +75,6 @@ exports.DEFAULT_REPUTATION_CONFIG = {
     minReputation: 0,
     challengeThreshold: 5,
 };
-/**
- * Default oracle configuration
- */
-exports.DEFAULT_ORACLE_CONFIG = {
-    minStake: 100,
-    slashCooldownEpochs: 7,
-    accuracyThreshold: 70,
-    maxDisputeRate: 30,
-};
 // ---------------------------------------------------------------------------
 // State Machine Definitions (generated from JSON at build time)
 // ---------------------------------------------------------------------------
@@ -100,7 +92,7 @@ exports.IDENTITY_DEFINITIONS = {
  * Get an identity state machine definition by type.
  * @param type - 'universal' | 'agent' | 'oracle' (default: 'agent')
  */
-function getIdentityDefinition(type = 'agent') {
+function getIdentityDefinition(type = "agent") {
     return exports.IDENTITY_DEFINITIONS[type];
 }
 exports.getIdentityDefinition = getIdentityDefinition;

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

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identityAgentDef = void 0;
+const fiber_app_js_1 = require("../../../schema/fiber-app.js");
+/**
+ * Standard agent identity with reputation tracking, vouching, and lifecycle management.
+ */
+exports.identityAgentDef = (0, fiber_app_js_1.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" }],
+            },
+        },
+    ],
+});