@ottochain/sdk 2.0.0 → 2.2.0

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

@@ -1,29 +1,43 @@
 /**
  * Identity Constants
  *
- * State machine transitions and configuration constants for agent identity.
+ * State machine transitions and configuration constants for identity types.
  *
  * @packageDocumentation
  */
-import { AgentState } from '../../generated/ottochain/apps/identity/v1/agent.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 agent state.
+ * Valid transitions for each identity state.
  * Maps current state to allowed event names.
+ * Note: Some transitions are type-specific (agent vs oracle)
  */
-export const AGENT_TRANSITIONS = {
-    [AgentState.AGENT_STATE_UNSPECIFIED]: [],
-    [AgentState.AGENT_STATE_REGISTERED]: ['activate', 'withdraw'],
-    [AgentState.AGENT_STATE_ACTIVE]: ['challenge', 'withdraw'],
-    [AgentState.AGENT_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
-    [AgentState.AGENT_STATE_SUSPENDED]: ['begin_probation'],
-    [AgentState.AGENT_STATE_PROBATION]: ['complete_probation'],
-    [AgentState.AGENT_STATE_WITHDRAWN]: [], // Terminal state
-    [AgentState.UNRECOGNIZED]: [],
+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]: [],
 };
+// Legacy alias
+export const AGENT_TRANSITIONS = IDENTITY_TRANSITIONS;
 // ---------------------------------------------------------------------------
 // Reputation Configuration
 // ---------------------------------------------------------------------------
@@ -43,7 +57,7 @@ export const ATTESTATION_DELTAS = {
  * Check if a transition is valid for the given state.
  */
 export function canTransition(state, event) {
-    return AGENT_TRANSITIONS[state]?.includes(event) ?? false;
+    return IDENTITY_TRANSITIONS[state]?.includes(event) ?? false;
 }
 /**
  * Get reputation delta for an attestation type.

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

@@ -17,10 +17,12 @@
  * @packageDocumentation
  */
 // Re-export generated protobuf types (source of truth)
-export { AgentState, Platform, PlatformLink, AgentIdentity, AgentIdentityDefinition, agentStateFromJSON, agentStateToJSON, platformFromJSON, platformToJSON, } from '../../generated/ottochain/apps/identity/v1/agent.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 { AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from './constants.js';
+export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from "./constants.js";
 // ---------------------------------------------------------------------------
 // Configuration Defaults
 // ---------------------------------------------------------------------------
@@ -39,7 +41,7 @@ export const DEFAULT_REPUTATION_CONFIG = {
 // ---------------------------------------------------------------------------
 // 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 = {
@@ -51,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" }],
+            },
+        },
+    ],
+});

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

@@ -0,0 +1,318 @@
+import { defineFiberApp } from "../../../schema/fiber-app.js";
+/**
+ * Oracle identity with staking, attestations, reputation, and slashing mechanics.
+ */
+export const identityOracleDef = defineFiberApp({
+    metadata: {
+        name: "IdentityOracle",
+        app: "identity",
+        type: "oracle",
+        version: "1.0.0",
+        description: "Oracle identity with staking, attestations, reputation, and slashing mechanics",
+    },
+    createSchema: {
+        required: ["owner", "stake", "domains"],
+        properties: {
+            owner: {
+                type: "address",
+                description: "Oracle owner DAG address",
+                immutable: true,
+            },
+            stake: {
+                type: "integer",
+                minimum: 0,
+                description: "Initial stake amount",
+            },
+            domains: {
+                type: "array",
+                items: { type: "string" },
+                description: "Oracle specialization domains",
+            },
+            minStake: {
+                type: "integer",
+                default: 1000,
+                description: "Minimum stake required",
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            owner: { type: "address", immutable: true },
+            address: { type: "address", computed: true },
+            stake: { type: "integer", computed: true },
+            minStake: { type: "integer" },
+            domains: { type: "array", items: { type: "string" } },
+            status: {
+                type: "string",
+                enum: [
+                    "UNREGISTERED",
+                    "REGISTERED",
+                    "ACTIVE",
+                    "SLASHED",
+                    "WITHDRAWN",
+                ],
+                computed: true,
+            },
+            reputation: {
+                type: "object",
+                properties: {
+                    accuracy: { type: "integer" },
+                    totalResolutions: { type: "integer" },
+                    disputesWon: { type: "integer" },
+                    disputesLost: { type: "integer" },
+                },
+                computed: true,
+            },
+            slashingHistory: { type: "array", computed: true },
+            registeredAt: { type: "timestamp", computed: true },
+            activatedAt: { type: "timestamp", computed: true },
+            slashedAt: { type: "timestamp", computed: true },
+            withdrawnAt: { type: "timestamp", computed: true },
+        },
+    },
+    eventSchemas: {
+        register: {
+            description: "Register as an oracle with initial stake",
+            required: ["agent", "stake", "domains"],
+            properties: {
+                agent: { type: "address" },
+                stake: { type: "integer", minimum: 0 },
+                domains: { type: "array", items: { type: "string" } },
+            },
+        },
+        activate: {
+            description: "Activate a registered oracle",
+            required: ["agent"],
+            properties: {
+                agent: { type: "address" },
+                adminOverride: { type: "boolean", default: false },
+            },
+        },
+        add_stake: {
+            description: "Add stake to an active oracle",
+            required: ["agent", "amount"],
+            properties: {
+                agent: { type: "address" },
+                amount: { type: "integer", minimum: 1 },
+            },
+        },
+        record_resolution: {
+            description: "Record a market resolution outcome",
+            required: ["marketId", "correct"],
+            properties: {
+                marketId: { type: "uuid" },
+                correct: { type: "boolean" },
+            },
+        },
+        slash: {
+            description: "Slash oracle stake for misconduct",
+            required: ["reason", "amount"],
+            properties: {
+                reason: { type: "string" },
+                amount: { type: "integer", minimum: 1 },
+                marketId: { type: "uuid" },
+            },
+        },
+        reactivate: {
+            description: "Reactivate a slashed oracle",
+            required: ["agent"],
+            properties: {
+                agent: { type: "address" },
+            },
+        },
+        withdraw: {
+            description: "Withdraw oracle and reclaim stake",
+            required: ["agent"],
+            properties: {
+                agent: { type: "address" },
+            },
+        },
+    },
+    states: {
+        UNREGISTERED: { id: "UNREGISTERED", isFinal: false },
+        REGISTERED: { id: "REGISTERED", isFinal: false },
+        ACTIVE: { id: "ACTIVE", isFinal: false },
+        SLASHED: { id: "SLASHED", isFinal: false },
+        WITHDRAWN: { id: "WITHDRAWN", isFinal: true },
+    },
+    initialState: "UNREGISTERED",
+    transitions: [
+        {
+            from: "UNREGISTERED",
+            to: "REGISTERED",
+            eventName: "register",
+            guard: { ">=": [{ var: "event.stake" }, { var: "state.minStake" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "REGISTERED",
+                        address: { var: "event.agent" },
+                        stake: { var: "event.stake" },
+                        registeredAt: { var: "$timestamp" },
+                        reputation: {
+                            accuracy: 100,
+                            totalResolutions: 0,
+                            disputesWon: 0,
+                            disputesLost: 0,
+                        },
+                        domains: { var: "event.domains" },
+                        slashingHistory: [],
+                    },
+                ],
+            },
+        },
+        {
+            from: "REGISTERED",
+            to: "ACTIVE",
+            eventName: "activate",
+            guard: {
+                or: [
+                    { "===": [{ var: "event.agent" }, { var: "state.address" }] },
+                    { var: "event.adminOverride" },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", activatedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "add_stake",
+            guard: {
+                and: [
+                    { "===": [{ var: "event.agent" }, { var: "state.address" }] },
+                    { ">": [{ var: "event.amount" }, 0] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        stake: { "+": [{ var: "state.stake" }, { var: "event.amount" }] },
+                        lastStakeAt: { var: "$timestamp" },
+                    },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "record_resolution",
+            guard: { var: "event.marketId" },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        reputation: {
+                            merge: [
+                                { var: "state.reputation" },
+                                {
+                                    totalResolutions: {
+                                        "+": [{ var: "state.reputation.totalResolutions" }, 1],
+                                    },
+                                    accuracy: {
+                                        if: [
+                                            { var: "event.correct" },
+                                            { var: "state.reputation.accuracy" },
+                                            { "-": [{ var: "state.reputation.accuracy" }, 5] },
+                                        ],
+                                    },
+                                },
+                            ],
+                        },
+                        lastResolutionAt: { var: "$timestamp" },
+                    },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "SLASHED",
+            eventName: "slash",
+            guard: {
+                and: [
+                    { var: "event.reason" },
+                    { ">": [{ var: "event.amount" }, 0] },
+                    { "<=": [{ var: "event.amount" }, { var: "state.stake" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "SLASHED",
+                        stake: { "-": [{ var: "state.stake" }, { var: "event.amount" }] },
+                        slashingHistory: {
+                            cat: [
+                                { var: "state.slashingHistory" },
+                                [
+                                    {
+                                        reason: { var: "event.reason" },
+                                        amount: { var: "event.amount" },
+                                        marketId: { var: "event.marketId" },
+                                        slashedAt: { var: "$timestamp" },
+                                    },
+                                ],
+                            ],
+                        },
+                        slashedAt: { var: "$timestamp" },
+                    },
+                ],
+            },
+        },
+        {
+            from: "SLASHED",
+            to: "ACTIVE",
+            eventName: "reactivate",
+            guard: {
+                and: [
+                    { "===": [{ var: "event.agent" }, { var: "state.address" }] },
+                    { ">=": [{ var: "state.stake" }, { var: "state.minStake" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", reactivatedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.address" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "WITHDRAWN",
+                        withdrawnAt: { var: "$timestamp" },
+                        finalStake: { var: "state.stake" },
+                    },
+                ],
+            },
+        },
+        {
+            from: "SLASHED",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.address" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "WITHDRAWN",
+                        withdrawnAt: { var: "$timestamp" },
+                        finalStake: { var: "state.stake" },
+                    },
+                ],
+            },
+        },
+    ],
+});