@ottochain/sdk 2.0.0 → 2.1.0

package/dist/types/apps/governance/state-machines/dao-reputation.d.ts

@@ -0,0 +1,610 @@
+/**
+ * Reputation-based governance. Minimum reputation required for participation.
+ */
+export declare const daoReputationDef: {
+    readonly metadata: {
+        readonly name: "DAOReputation";
+        readonly app: "governance";
+        readonly type: "daoReputation";
+        readonly version: "1.0.0";
+        readonly description: "Reputation-based governance. Minimum reputation required for participation.";
+        readonly category: "governance/dao";
+        readonly crossReferences: {
+            readonly Identity: "member verification";
+            readonly Reputation: "threshold checks";
+            readonly Contract: "action execution";
+        };
+    };
+    readonly createSchema: {
+        readonly required: readonly ["memberThreshold", "voteThreshold", "proposeThreshold", "quorum", "votingPeriodMs"];
+        readonly properties: {
+            readonly memberThreshold: {
+                readonly type: "number";
+                readonly description: "Min reputation to join as a member";
+            };
+            readonly voteThreshold: {
+                readonly type: "number";
+                readonly description: "Min reputation to vote";
+            };
+            readonly proposeThreshold: {
+                readonly type: "number";
+                readonly description: "Min reputation to submit a proposal";
+            };
+            readonly quorum: {
+                readonly type: "number";
+                readonly description: "Min total votes (count) to execute";
+            };
+            readonly votingPeriodMs: {
+                readonly type: "number";
+                readonly description: "Voting window in milliseconds";
+            };
+        };
+    };
+    readonly stateSchema: {
+        readonly properties: {
+            readonly members: {
+                readonly type: "array";
+                readonly computed: true;
+            };
+            readonly memberJoinedAt: {
+                readonly type: "object";
+                readonly computed: true;
+            };
+            readonly memberThreshold: {
+                readonly type: "number";
+            };
+            readonly voteThreshold: {
+                readonly type: "number";
+            };
+            readonly proposeThreshold: {
+                readonly type: "number";
+            };
+            readonly quorum: {
+                readonly type: "number";
+            };
+            readonly votingPeriodMs: {
+                readonly type: "number";
+            };
+            readonly proposal: {
+                readonly type: "object";
+            };
+            readonly votes: {
+                readonly type: "object";
+                readonly computed: true;
+            };
+            readonly history: {
+                readonly type: "array";
+                readonly computed: true;
+            };
+        };
+    };
+    readonly eventSchemas: {
+        readonly propose: {
+            readonly description: "Submit a proposal (requires >= proposeThreshold reputation)";
+            readonly required: readonly ["proposalId", "title", "description", "actionType", "payload", "agentReputation"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly agentReputation: {
+                    readonly type: "number";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+                readonly actionType: {
+                    readonly type: "string";
+                };
+                readonly payload: {
+                    readonly type: "object";
+                };
+            };
+        };
+        readonly vote: {
+            readonly description: "Cast a vote (requires >= voteThreshold, no double-vote, within window)";
+            readonly required: readonly ["vote", "agentReputation"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly agentReputation: {
+                    readonly type: "number";
+                };
+                readonly vote: {
+                    readonly type: "string";
+                    readonly description: "\"for\" | \"against\" | \"abstain\"";
+                };
+            };
+        };
+        readonly execute: {
+            readonly description: "Execute a passing proposal after voting ends";
+            readonly properties: {};
+        };
+        readonly reject: {
+            readonly description: "Formally reject a failed proposal";
+            readonly properties: {};
+        };
+        readonly join: {
+            readonly description: "Join the DAO (requires >= memberThreshold reputation)";
+            readonly required: readonly ["agentReputation"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly agentReputation: {
+                    readonly type: "number";
+                };
+            };
+        };
+        readonly leave: {
+            readonly description: "Leave the DAO voluntarily";
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly propose_threshold_change: {
+            readonly description: "Propose changing reputation thresholds";
+            readonly required: readonly ["proposalId", "agentReputation"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly agentReputation: {
+                    readonly type: "number";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly memberThreshold: {
+                    readonly type: "number";
+                };
+                readonly voteThreshold: {
+                    readonly type: "number";
+                };
+                readonly proposeThreshold: {
+                    readonly type: "number";
+                };
+            };
+        };
+    };
+    readonly states: {
+        readonly ACTIVE: {
+            readonly id: "ACTIVE";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly VOTING: {
+            readonly id: "VOTING";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly DISSOLVED: {
+            readonly id: "DISSOLVED";
+            readonly isFinal: true;
+            readonly metadata: null;
+        };
+    };
+    readonly initialState: "ACTIVE";
+    readonly transitions: readonly [{
+        readonly from: "ACTIVE";
+        readonly to: "VOTING";
+        readonly eventName: "propose";
+        readonly guard: {
+            readonly ">=": readonly [{
+                readonly var: "event.agentReputation";
+            }, {
+                readonly var: "state.proposeThreshold";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly title: {
+                        readonly var: "event.title";
+                    };
+                    readonly description: {
+                        readonly var: "event.description";
+                    };
+                    readonly actionType: {
+                        readonly var: "event.actionType";
+                    };
+                    readonly payload: {
+                        readonly var: "event.payload";
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly deadline: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.votingPeriodMs";
+                        }];
+                    };
+                };
+                readonly votes: {
+                    readonly for: readonly [];
+                    readonly against: readonly [];
+                    readonly abstain: readonly [];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "VOTING";
+        readonly to: "VOTING";
+        readonly eventName: "vote";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly ">=": readonly [{
+                    readonly var: "event.agentReputation";
+                }, {
+                    readonly var: "state.voteThreshold";
+                }];
+            }, {
+                readonly "!": readonly [{
+                    readonly in: readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.votes.for";
+                    }];
+                }];
+            }, {
+                readonly "!": readonly [{
+                    readonly in: readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.votes.against";
+                    }];
+                }];
+            }, {
+                readonly "!": readonly [{
+                    readonly in: readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.votes.abstain";
+                    }];
+                }];
+            }, {
+                readonly "<=": readonly [{
+                    readonly var: "$timestamp";
+                }, {
+                    readonly var: "state.proposal.deadline";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly votes: {
+                    readonly if: readonly [{
+                        readonly "===": readonly [{
+                            readonly var: "event.vote";
+                        }, "for"];
+                    }, {
+                        readonly merge: readonly [{
+                            readonly var: "state.votes";
+                        }, {
+                            readonly for: {
+                                readonly cat: readonly [{
+                                    readonly var: "state.votes.for";
+                                }, readonly [{
+                                    readonly var: "event.agent";
+                                }]];
+                            };
+                        }];
+                    }, {
+                        readonly "===": readonly [{
+                            readonly var: "event.vote";
+                        }, "against"];
+                    }, {
+                        readonly merge: readonly [{
+                            readonly var: "state.votes";
+                        }, {
+                            readonly against: {
+                                readonly cat: readonly [{
+                                    readonly var: "state.votes.against";
+                                }, readonly [{
+                                    readonly var: "event.agent";
+                                }]];
+                            };
+                        }];
+                    }, {
+                        readonly merge: readonly [{
+                            readonly var: "state.votes";
+                        }, {
+                            readonly abstain: {
+                                readonly cat: readonly [{
+                                    readonly var: "state.votes.abstain";
+                                }, readonly [{
+                                    readonly var: "event.agent";
+                                }]];
+                            };
+                        }];
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "VOTING";
+        readonly to: "ACTIVE";
+        readonly eventName: "execute";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly ">": readonly [{
+                    readonly var: "$timestamp";
+                }, {
+                    readonly var: "state.proposal.deadline";
+                }];
+            }, {
+                readonly ">": readonly [{
+                    readonly size: {
+                        readonly var: "state.votes.for";
+                    };
+                }, {
+                    readonly size: {
+                        readonly var: "state.votes.against";
+                    };
+                }];
+            }, {
+                readonly ">=": readonly [{
+                    readonly "+": readonly [{
+                        readonly size: {
+                            readonly var: "state.votes.for";
+                        };
+                    }, {
+                        readonly size: {
+                            readonly var: "state.votes.against";
+                        };
+                    }];
+                }, {
+                    readonly var: "state.quorum";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly history: {
+                    readonly cat: readonly [{
+                        readonly var: "state.history";
+                    }, readonly [{
+                        readonly type: "executed";
+                        readonly proposal: {
+                            readonly var: "state.proposal";
+                        };
+                        readonly votes: {
+                            readonly var: "state.votes";
+                        };
+                        readonly at: {
+                            readonly var: "$timestamp";
+                        };
+                    }]];
+                };
+                readonly proposal: null;
+                readonly votes: null;
+            }];
+        };
+        readonly emits: readonly [{
+            readonly event: "proposal_executed";
+            readonly to: "Reputation";
+            readonly payload: {
+                readonly action: "increase";
+                readonly agents: {
+                    readonly var: "state.votes.for";
+                };
+            };
+        }];
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "VOTING";
+        readonly to: "ACTIVE";
+        readonly eventName: "reject";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly ">": readonly [{
+                    readonly var: "$timestamp";
+                }, {
+                    readonly var: "state.proposal.deadline";
+                }];
+            }, {
+                readonly or: readonly [{
+                    readonly "<=": readonly [{
+                        readonly size: {
+                            readonly var: "state.votes.for";
+                        };
+                    }, {
+                        readonly size: {
+                            readonly var: "state.votes.against";
+                        };
+                    }];
+                }, {
+                    readonly "<": readonly [{
+                        readonly "+": readonly [{
+                            readonly size: {
+                                readonly var: "state.votes.for";
+                            };
+                        }, {
+                            readonly size: {
+                                readonly var: "state.votes.against";
+                            };
+                        }];
+                    }, {
+                        readonly var: "state.quorum";
+                    }];
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly history: {
+                    readonly cat: readonly [{
+                        readonly var: "state.history";
+                    }, readonly [{
+                        readonly type: "rejected";
+                        readonly proposal: {
+                            readonly var: "state.proposal";
+                        };
+                        readonly votes: {
+                            readonly var: "state.votes";
+                        };
+                        readonly at: {
+                            readonly var: "$timestamp";
+                        };
+                    }]];
+                };
+                readonly proposal: null;
+                readonly votes: null;
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "ACTIVE";
+        readonly eventName: "join";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly ">=": readonly [{
+                    readonly var: "event.agentReputation";
+                }, {
+                    readonly var: "state.memberThreshold";
+                }];
+            }, {
+                readonly "!": readonly [{
+                    readonly in: readonly [{
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "state.members";
+                    }];
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly members: {
+                    readonly cat: readonly [{
+                        readonly var: "state.members";
+                    }, readonly [{
+                        readonly var: "event.agent";
+                    }]];
+                };
+                readonly memberJoinedAt: {
+                    readonly setKey: readonly [{
+                        readonly var: "state.memberJoinedAt";
+                    }, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "ACTIVE";
+        readonly eventName: "leave";
+        readonly guard: {
+            readonly in: readonly [{
+                readonly var: "event.agent";
+            }, {
+                readonly var: "state.members";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly members: {
+                    readonly filter: readonly [{
+                        readonly var: "state.members";
+                    }, {
+                        readonly "!==": readonly [{
+                            readonly var: "";
+                        }, {
+                            readonly var: "event.agent";
+                        }];
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "VOTING";
+        readonly eventName: "propose_threshold_change";
+        readonly guard: {
+            readonly ">=": readonly [{
+                readonly var: "event.agentReputation";
+            }, {
+                readonly var: "state.proposeThreshold";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly title: "Threshold Change";
+                    readonly actionType: "threshold_change";
+                    readonly payload: {
+                        readonly memberThreshold: {
+                            readonly var: "event.memberThreshold";
+                        };
+                        readonly voteThreshold: {
+                            readonly var: "event.voteThreshold";
+                        };
+                        readonly proposeThreshold: {
+                            readonly var: "event.proposeThreshold";
+                        };
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly deadline: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.votingPeriodMs";
+                        }];
+                    };
+                };
+                readonly votes: {
+                    readonly for: readonly [];
+                    readonly against: readonly [];
+                    readonly abstain: readonly [];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }];
+};