@ottochain/sdk 2.0.0 → 2.2.0

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

@@ -0,0 +1,644 @@
+/**
+ * N-of-M multisig governance. Requires threshold signatures for actions.
+ */
+export declare const daoMultisigDef: {
+    readonly metadata: {
+        readonly name: "MultisigDAO";
+        readonly app: "governance";
+        readonly type: "daoMultisig";
+        readonly version: "1.0.0";
+        readonly description: "N-of-M multisig governance. Requires threshold signatures for actions.";
+        readonly category: "governance/dao";
+        readonly crossReferences: {
+            readonly Identity: "signer verification";
+            readonly Contract: "action execution targets";
+            readonly Treasury: "fund management";
+            readonly Escrow: "controlled release";
+        };
+    };
+    readonly createSchema: {
+        readonly required: readonly ["signers", "threshold", "proposalTTLMs"];
+        readonly properties: {
+            readonly signers: {
+                readonly type: "array";
+                readonly description: "Authorized signer addresses";
+                readonly immutable: false;
+            };
+            readonly threshold: {
+                readonly type: "number";
+                readonly description: "Number of signatures required to execute";
+            };
+            readonly proposalTTLMs: {
+                readonly type: "number";
+                readonly description: "Proposal expiry window in milliseconds";
+            };
+        };
+    };
+    readonly stateSchema: {
+        readonly properties: {
+            readonly signers: {
+                readonly type: "array";
+            };
+            readonly threshold: {
+                readonly type: "number";
+            };
+            readonly proposalTTLMs: {
+                readonly type: "number";
+            };
+            readonly proposal: {
+                readonly type: "object";
+            };
+            readonly signatures: {
+                readonly type: "object";
+                readonly computed: true;
+            };
+            readonly actions: {
+                readonly type: "array";
+                readonly computed: true;
+            };
+            readonly cancelledProposals: {
+                readonly type: "array";
+                readonly computed: true;
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly computed: true;
+            };
+        };
+    };
+    readonly eventSchemas: {
+        readonly propose: {
+            readonly description: "Propose an action (signer only)";
+            readonly required: readonly ["proposalId", "actionType", "payload"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly actionType: {
+                    readonly type: "string";
+                };
+                readonly payload: {
+                    readonly type: "object";
+                };
+            };
+        };
+        readonly sign: {
+            readonly description: "Sign the current proposal (signer only, no double-signing)";
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly execute: {
+            readonly description: "Execute once threshold signatures collected";
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly cancel: {
+            readonly description: "Cancel proposal (expired or proposer)";
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly propose_add_signer: {
+            readonly description: "Propose adding a new signer (signer only)";
+            readonly required: readonly ["proposalId", "newSigner"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly newSigner: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly propose_remove_signer: {
+            readonly description: "Propose removing a signer (signer only, must keep > threshold signers)";
+            readonly required: readonly ["proposalId", "removeSigner"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly removeSigner: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly propose_change_threshold: {
+            readonly description: "Propose changing the signature threshold";
+            readonly required: readonly ["proposalId", "newThreshold"];
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+                readonly proposalId: {
+                    readonly type: "string";
+                };
+                readonly newThreshold: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                };
+            };
+        };
+        readonly apply_signer_change: {
+            readonly description: "Apply approved signer-set or threshold change";
+            readonly properties: {
+                readonly agent: {
+                    readonly type: "address";
+                };
+            };
+        };
+        readonly dissolve: {
+            readonly description: "Dissolve the DAO (requires unanimous signer count)";
+            readonly properties: {
+                readonly signatureCount: {
+                    readonly type: "number";
+                };
+            };
+        };
+    };
+    readonly states: {
+        readonly ACTIVE: {
+            readonly id: "ACTIVE";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly PENDING: {
+            readonly id: "PENDING";
+            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: "PENDING";
+        readonly eventName: "propose";
+        readonly guard: {
+            readonly in: readonly [{
+                readonly var: "event.agent";
+            }, {
+                readonly var: "state.signers";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly actionType: {
+                        readonly var: "event.actionType";
+                    };
+                    readonly payload: {
+                        readonly var: "event.payload";
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly expiresAt: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.proposalTTLMs";
+                        }];
+                    };
+                };
+                readonly signatures: {
+                    readonly setKey: readonly [{}, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "PENDING";
+        readonly to: "PENDING";
+        readonly eventName: "sign";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly in: readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.signers";
+                }];
+            }, {
+                readonly "!": readonly [{
+                    readonly getKey: readonly [{
+                        readonly var: "state.signatures";
+                    }, {
+                        readonly var: "event.agent";
+                    }];
+                }];
+            }, {
+                readonly "<": readonly [{
+                    readonly size: {
+                        readonly var: "state.signatures";
+                    };
+                }, {
+                    readonly var: "state.threshold";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly signatures: {
+                    readonly setKey: readonly [{
+                        readonly var: "state.signatures";
+                    }, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "PENDING";
+        readonly to: "ACTIVE";
+        readonly eventName: "execute";
+        readonly guard: {
+            readonly ">=": readonly [{
+                readonly size: {
+                    readonly var: "state.signatures";
+                };
+            }, {
+                readonly var: "state.threshold";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly actions: {
+                    readonly cat: readonly [{
+                        readonly var: "state.actions";
+                    }, readonly [{
+                        readonly id: {
+                            readonly var: "state.proposal.id";
+                        };
+                        readonly type: {
+                            readonly var: "state.proposal.actionType";
+                        };
+                        readonly payload: {
+                            readonly var: "state.proposal.payload";
+                        };
+                        readonly signatures: {
+                            readonly var: "state.signatures";
+                        };
+                        readonly executedAt: {
+                            readonly var: "$timestamp";
+                        };
+                    }]];
+                };
+                readonly proposal: null;
+                readonly signatures: {};
+            }];
+        };
+        readonly emits: readonly [{
+            readonly event: "multisig_executed";
+            readonly to: "external";
+        }];
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "PENDING";
+        readonly to: "ACTIVE";
+        readonly eventName: "cancel";
+        readonly guard: {
+            readonly or: readonly [{
+                readonly ">": readonly [{
+                    readonly var: "$timestamp";
+                }, {
+                    readonly var: "state.proposal.expiresAt";
+                }];
+            }, {
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.proposal.proposer";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly cancelledProposals: {
+                    readonly cat: readonly [{
+                        readonly var: "state.cancelledProposals";
+                    }, readonly [{
+                        readonly merge: readonly [{
+                            readonly var: "state.proposal";
+                        }, {
+                            readonly cancelledAt: {
+                                readonly var: "$timestamp";
+                            };
+                        }];
+                    }]];
+                };
+                readonly proposal: null;
+                readonly signatures: {};
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "PENDING";
+        readonly eventName: "propose_add_signer";
+        readonly guard: {
+            readonly in: readonly [{
+                readonly var: "event.agent";
+            }, {
+                readonly var: "state.signers";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly actionType: "add_signer";
+                    readonly payload: {
+                        readonly newSigner: {
+                            readonly var: "event.newSigner";
+                        };
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly expiresAt: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.proposalTTLMs";
+                        }];
+                    };
+                };
+                readonly signatures: {
+                    readonly setKey: readonly [{}, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "PENDING";
+        readonly eventName: "propose_remove_signer";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly in: readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.signers";
+                }];
+            }, {
+                readonly ">": readonly [{
+                    readonly size: {
+                        readonly var: "state.signers";
+                    };
+                }, {
+                    readonly var: "state.threshold";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly actionType: "remove_signer";
+                    readonly payload: {
+                        readonly removeSigner: {
+                            readonly var: "event.removeSigner";
+                        };
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly expiresAt: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.proposalTTLMs";
+                        }];
+                    };
+                };
+                readonly signatures: {
+                    readonly setKey: readonly [{}, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "PENDING";
+        readonly eventName: "propose_change_threshold";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly in: readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.signers";
+                }];
+            }, {
+                readonly ">=": readonly [{
+                    readonly var: "event.newThreshold";
+                }, 1];
+            }, {
+                readonly "<=": readonly [{
+                    readonly var: "event.newThreshold";
+                }, {
+                    readonly size: {
+                        readonly var: "state.signers";
+                    };
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly proposal: {
+                    readonly id: {
+                        readonly var: "event.proposalId";
+                    };
+                    readonly actionType: "change_threshold";
+                    readonly payload: {
+                        readonly newThreshold: {
+                            readonly var: "event.newThreshold";
+                        };
+                    };
+                    readonly proposer: {
+                        readonly var: "event.agent";
+                    };
+                    readonly proposedAt: {
+                        readonly var: "$timestamp";
+                    };
+                    readonly expiresAt: {
+                        readonly "+": readonly [{
+                            readonly var: "$timestamp";
+                        }, {
+                            readonly var: "state.proposalTTLMs";
+                        }];
+                    };
+                };
+                readonly signatures: {
+                    readonly setKey: readonly [{}, {
+                        readonly var: "event.agent";
+                    }, {
+                        readonly var: "$timestamp";
+                    }];
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "PENDING";
+        readonly to: "ACTIVE";
+        readonly eventName: "apply_signer_change";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly ">=": readonly [{
+                    readonly size: {
+                        readonly var: "state.signatures";
+                    };
+                }, {
+                    readonly var: "state.threshold";
+                }];
+            }, {
+                readonly in: readonly [{
+                    readonly var: "state.proposal.actionType";
+                }, readonly ["add_signer", "remove_signer", "change_threshold"]];
+            }];
+        };
+        readonly effect: {
+            readonly if: readonly [{
+                readonly "===": readonly [{
+                    readonly var: "state.proposal.actionType";
+                }, "add_signer"];
+            }, {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly signers: {
+                        readonly cat: readonly [{
+                            readonly var: "state.signers";
+                        }, readonly [{
+                            readonly var: "state.proposal.payload.newSigner";
+                        }]];
+                    };
+                    readonly proposal: null;
+                    readonly signatures: {};
+                }];
+            }, {
+                readonly "===": readonly [{
+                    readonly var: "state.proposal.actionType";
+                }, "remove_signer"];
+            }, {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly signers: {
+                        readonly filter: readonly [{
+                            readonly var: "state.signers";
+                        }, {
+                            readonly "!==": readonly [{
+                                readonly var: "";
+                            }, {
+                                readonly var: "state.proposal.payload.removeSigner";
+                            }];
+                        }];
+                    };
+                    readonly proposal: null;
+                    readonly signatures: {};
+                }];
+            }, {
+                readonly merge: readonly [{
+                    readonly var: "state";
+                }, {
+                    readonly threshold: {
+                        readonly var: "state.proposal.payload.newThreshold";
+                    };
+                    readonly proposal: null;
+                    readonly signatures: {};
+                }];
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "DISSOLVED";
+        readonly eventName: "dissolve";
+        readonly guard: {
+            readonly "===": readonly [{
+                readonly var: "event.signatureCount";
+            }, {
+                readonly size: {
+                    readonly var: "state.signers";
+                };
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly dissolvedAt: {
+                    readonly var: "$timestamp";
+                };
+                readonly status: "DISSOLVED";
+            }];
+        };
+        readonly dependencies: readonly [];
+    }];
+};