@ottochain/sdk 1.6.0 → 1.7.0-beta.2

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

@@ -1,17 +1,18 @@
 /**
  * Identity Constants
  *
- * State machine transitions and configuration constants for agent identity.
+ * State machine transitions and configuration constants for identities.
  *
  * @packageDocumentation
  */
-import { AgentState } from '../../generated/ottochain/apps/identity/v1/agent.js';
+import { IdentityState, IdentityType } from '../../generated/ottochain/apps/identity/v1/identity.js';
 import { AttestationType } from '../../generated/ottochain/apps/identity/v1/attestation.js';
 /**
- * Valid transitions for each agent state.
+ * Valid transitions for each identity state.
  * Maps current state to allowed event names.
  */
-export declare const AGENT_TRANSITIONS: Record<AgentState, readonly string[]>;
+export declare const IDENTITY_TRANSITIONS: Record<IdentityState, readonly string[]>;
+export declare const AGENT_TRANSITIONS: Record<IdentityState, readonly string[]>;
 /**
  * Reputation delta by attestation type.
  * These values match the metagraph state machine defaults.
@@ -20,8 +21,12 @@ export declare const ATTESTATION_DELTAS: Record<AttestationType, number>;
 /**
  * Check if a transition is valid for the given state.
  */
-export declare function canTransition(state: AgentState, event: string): boolean;
+export declare function canTransition(state: IdentityState, event: string): boolean;
 /**
  * Get reputation delta for an attestation type.
  */
 export declare function getReputationDelta(type: AttestationType): number;
+/**
+ * Identity type display names
+ */
+export declare const IDENTITY_TYPE_NAMES: Record<IdentityType, string>;

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

@@ -1,26 +1,28 @@
 /**
- * Agent Identity Application
+ * Identity Application
  *
- * Types and utilities for the Agent Identity system on OttoChain.
+ * Types and utilities for the Identity system on OttoChain.
+ * Includes agents, oracles, and services.
  *
  * @example
  * ```typescript
  * import {
- *   AgentState,
- *   AgentIdentity,
+ *   IdentityState,
+ *   IdentityType,
  *   getIdentityDefinition
  * } from '@ottochain/sdk/apps/identity';
  *
- * const identityDef = getIdentityDefinition();
+ * const oracleDef = getIdentityDefinition('oracle');
  * ```
  *
  * @packageDocumentation
  */
-export { AgentState, Platform, PlatformLink, AgentIdentity, AgentIdentityDefinition, agentStateFromJSON, agentStateToJSON, platformFromJSON, platformToJSON, } from '../../generated/ottochain/apps/identity/v1/agent.js';
+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 { AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from './constants.js';
+export { IDENTITY_TRANSITIONS, AGENT_TRANSITIONS, // Legacy alias
+ATTESTATION_DELTAS, IDENTITY_TYPE_NAMES, canTransition, getReputationDelta, } from './constants.js';
 /**
- * Default reputation configuration for agent identity
+ * Default reputation configuration for identities
  */
 export declare const DEFAULT_REPUTATION_CONFIG: {
     readonly baseReputation: 10;
@@ -32,8 +34,614 @@ export declare const DEFAULT_REPUTATION_CONFIG: {
     readonly challengeThreshold: 5;
 };
 /**
- * Get the agent identity state machine definition.
- *
- * @returns The state machine definition JSON for AgentIdentity
+ * Default oracle configuration
+ */
+export declare const DEFAULT_ORACLE_CONFIG: {
+    readonly minStake: 100;
+    readonly slashCooldownEpochs: 7;
+    readonly accuracyThreshold: 70;
+    readonly maxDisputeRate: 30;
+};
+import { identityUniversalDef, identityAgentDef, identityOracleDef } from './state-machines/index.js';
+export { identityUniversalDef, identityAgentDef, identityOracleDef };
+/** All identity state machine definitions */
+export declare const IDENTITY_DEFINITIONS: {
+    readonly universal: {
+        readonly metadata: {
+            readonly name: "IdentityUniversal";
+            readonly description: "Minimal identity state machine - extend for custom use cases";
+            readonly version: "1.0.0";
+        };
+        readonly states: {
+            readonly CREATED: {
+                readonly id: "CREATED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly ACTIVE: {
+                readonly id: "ACTIVE";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly INACTIVE: {
+                readonly id: "INACTIVE";
+                readonly isFinal: true;
+                readonly metadata: null;
+            };
+        };
+        readonly initialState: "CREATED";
+        readonly transitions: readonly [{
+            readonly from: "CREATED";
+            readonly to: "ACTIVE";
+            readonly eventName: "activate";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly activatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "ACTIVE";
+            readonly eventName: "update";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly updatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly metadata: {
+                        readonly var: "event.metadata";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "INACTIVE";
+            readonly eventName: "deactivate";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "INACTIVE";
+                    readonly deactivatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }];
+    };
+    readonly agent: {
+        readonly metadata: {
+            readonly name: "IdentityAgent";
+            readonly description: "Standard agent identity with reputation tracking, vouching, and lifecycle management";
+            readonly version: "1.0.0";
+        };
+        readonly states: {
+            readonly REGISTERED: {
+                readonly id: "REGISTERED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly ACTIVE: {
+                readonly id: "ACTIVE";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly CHALLENGED: {
+                readonly id: "CHALLENGED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly SUSPENDED: {
+                readonly id: "SUSPENDED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly PROBATION: {
+                readonly id: "PROBATION";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly WITHDRAWN: {
+                readonly id: "WITHDRAWN";
+                readonly isFinal: true;
+                readonly metadata: null;
+            };
+        };
+        readonly initialState: "REGISTERED";
+        readonly transitions: readonly [{
+            readonly from: "REGISTERED";
+            readonly to: "ACTIVE";
+            readonly eventName: "activate";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly activatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "ACTIVE";
+            readonly eventName: "receive_vouch";
+            readonly guard: {
+                readonly "!!": readonly [{
+                    readonly var: "event.from";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly reputation: {
+                        readonly "+": readonly [{
+                            readonly var: "state.reputation";
+                        }, 2];
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "ACTIVE";
+            readonly eventName: "receive_completion";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly reputation: {
+                        readonly "+": readonly [{
+                            readonly var: "state.reputation";
+                        }, 5];
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "CHALLENGED";
+            readonly eventName: "challenge";
+            readonly guard: {
+                readonly "!!": readonly [{
+                    readonly var: "event.challenger";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "CHALLENGED";
+                    readonly challengedBy: {
+                        readonly var: "event.challenger";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "CHALLENGED";
+            readonly to: "ACTIVE";
+            readonly eventName: "dismiss_challenge";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly challengedBy: null;
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "CHALLENGED";
+            readonly to: "SUSPENDED";
+            readonly eventName: "uphold_challenge";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "SUSPENDED";
+                    readonly suspendedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "SUSPENDED";
+            readonly to: "PROBATION";
+            readonly eventName: "begin_probation";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "PROBATION";
+                    readonly probationStartedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "PROBATION";
+            readonly to: "ACTIVE";
+            readonly eventName: "complete_probation";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly probationStartedAt: null;
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "WITHDRAWN";
+            readonly eventName: "withdraw";
+            readonly guard: {
+                readonly "==": readonly [1, 1];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "WITHDRAWN";
+                }];
+            };
+            readonly dependencies: readonly [];
+        }];
+    };
+    readonly oracle: {
+        readonly metadata: {
+            readonly name: "IdentityOracle";
+            readonly description: "Oracle identity with staking, attestations, reputation, and slashing mechanics";
+            readonly version: "1.0.0";
+        };
+        readonly states: {
+            readonly UNREGISTERED: {
+                readonly id: "UNREGISTERED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly REGISTERED: {
+                readonly id: "REGISTERED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly ACTIVE: {
+                readonly id: "ACTIVE";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly SLASHED: {
+                readonly id: "SLASHED";
+                readonly isFinal: false;
+                readonly metadata: null;
+            };
+            readonly WITHDRAWN: {
+                readonly id: "WITHDRAWN";
+                readonly isFinal: true;
+                readonly metadata: null;
+            };
+        };
+        readonly initialState: "UNREGISTERED";
+        readonly transitions: readonly [{
+            readonly from: "UNREGISTERED";
+            readonly to: "REGISTERED";
+            readonly eventName: "register";
+            readonly guard: {
+                readonly ">=": readonly [{
+                    readonly var: "event.stake";
+                }, {
+                    readonly var: "state.minStake";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "REGISTERED";
+                    readonly address: {
+                        readonly var: "event.agent";
+                    };
+                    readonly stake: {
+                        readonly var: "event.stake";
+                    };
+                    readonly registeredAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly reputation: {
+                        readonly accuracy: 100;
+                        readonly totalResolutions: 0;
+                        readonly disputesWon: 0;
+                        readonly disputesLost: 0;
+                    };
+                    readonly domains: {
+                        readonly var: "event.domains";
+                    };
+                    readonly slashingHistory: readonly [];
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "REGISTERED";
+            readonly to: "ACTIVE";
+            readonly eventName: "activate";
+            readonly guard: {
+                readonly or: readonly [{
+                    readonly "===": readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.address";
+                    }];
+                }, {
+                    readonly var: "event.adminOverride";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly activatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "ACTIVE";
+            readonly eventName: "add_stake";
+            readonly guard: {
+                readonly and: readonly [{
+                    readonly "===": readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.address";
+                    }];
+                }, {
+                    readonly ">": readonly [{
+                        readonly var: "event.amount";
+                    }, 0];
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly stake: {
+                        readonly "+": readonly [{
+                            readonly var: "state.stake";
+                        }, {
+                            readonly var: "event.amount";
+                        }];
+                    };
+                    readonly lastStakeAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "ACTIVE";
+            readonly eventName: "record_resolution";
+            readonly guard: {
+                readonly var: "event.marketId";
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly reputation: {
+                        readonly merge: readonly [{
+                            readonly var: "state.reputation";
+                        }, {
+                            readonly totalResolutions: {
+                                readonly "+": readonly [{
+                                    readonly var: "state.reputation.totalResolutions";
+                                }, 1];
+                            };
+                            readonly accuracy: {
+                                readonly if: readonly [{
+                                    readonly var: "event.correct";
+                                }, {
+                                    readonly var: "state.reputation.accuracy";
+                                }, {
+                                    readonly "-": readonly [{
+                                        readonly var: "state.reputation.accuracy";
+                                    }, 5];
+                                }];
+                            };
+                        }];
+                    };
+                    readonly lastResolutionAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "SLASHED";
+            readonly eventName: "slash";
+            readonly guard: {
+                readonly and: readonly [{
+                    readonly var: "event.reason";
+                }, {
+                    readonly ">": readonly [{
+                        readonly var: "event.amount";
+                    }, 0];
+                }, {
+                    readonly "<=": readonly [{
+                        readonly var: "event.amount";
+                    }, {
+                        readonly var: "state.stake";
+                    }];
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "SLASHED";
+                    readonly stake: {
+                        readonly "-": readonly [{
+                            readonly var: "state.stake";
+                        }, {
+                            readonly var: "event.amount";
+                        }];
+                    };
+                    readonly slashingHistory: {
+                        readonly cat: readonly [{
+                            readonly var: "state.slashingHistory";
+                        }, readonly [{
+                            readonly reason: {
+                                readonly var: "event.reason";
+                            };
+                            readonly amount: {
+                                readonly var: "event.amount";
+                            };
+                            readonly marketId: {
+                                readonly var: "event.marketId";
+                            };
+                            readonly slashedAt: {
+                                readonly var: "$timestamp";
+                            };
+                        }]];
+                    };
+                    readonly slashedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "SLASHED";
+            readonly to: "ACTIVE";
+            readonly eventName: "reactivate";
+            readonly guard: {
+                readonly and: readonly [{
+                    readonly "===": readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.address";
+                    }];
+                }, {
+                    readonly ">=": readonly [{
+                        readonly var: "state.stake";
+                    }, {
+                        readonly var: "state.minStake";
+                    }];
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "ACTIVE";
+                    readonly reactivatedAt: {
+                        readonly var: "$timestamp";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "ACTIVE";
+            readonly to: "WITHDRAWN";
+            readonly eventName: "withdraw";
+            readonly guard: {
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.address";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "WITHDRAWN";
+                    readonly withdrawnAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly finalStake: {
+                        readonly var: "state.stake";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }, {
+            readonly from: "SLASHED";
+            readonly to: "WITHDRAWN";
+            readonly eventName: "withdraw";
+            readonly guard: {
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.address";
+                }];
+            };
+            readonly effect: {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly status: "WITHDRAWN";
+                    readonly withdrawnAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly finalStake: {
+                        readonly var: "state.stake";
+                    };
+                }];
+            };
+            readonly dependencies: readonly [];
+        }];
+    };
+};
+export type IdentityDefType = keyof typeof IDENTITY_DEFINITIONS;
+/**
+ * Get an identity state machine definition by type.
+ * @param type - 'universal' | 'agent' | 'oracle' (default: 'agent')
  */
-export declare function getIdentityDefinition(): unknown;
+export declare function getIdentityDefinition(type?: IdentityDefType): unknown;