@ottochain/sdk 2.2.5 → 2.4.0

package/dist/cjs/apps/governance/state-machines/dao-single.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.daoSingleDef = void 0;
 const fiber_app_js_1 = require("../../../schema/fiber-app.js");
+const guards_js_1 = require("../../../schema/guards.js");
 /**
  * Single owner controls all actions. Simplest governance model.
  */
@@ -78,9 +79,33 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
         },
     },
     states: {
-        ACTIVE: { id: "ACTIVE", isFinal: false, metadata: null },
-        TRANSFERRING: { id: "TRANSFERRING", isFinal: false, metadata: null },
-        DISSOLVED: { id: "DISSOLVED", isFinal: true, metadata: null },
+        ACTIVE: {
+            id: "ACTIVE",
+            isFinal: false,
+            metadata: {
+                label: "Active",
+                description: "Single owner controls the DAO and may act or transfer ownership",
+                category: "initial",
+            },
+        },
+        TRANSFERRING: {
+            id: "TRANSFERRING",
+            isFinal: false,
+            metadata: {
+                label: "Transferring",
+                description: "Ownership transfer proposed; awaiting acceptance",
+                category: "pending",
+            },
+        },
+        DISSOLVED: {
+            id: "DISSOLVED",
+            isFinal: true,
+            metadata: {
+                label: "Dissolved",
+                description: "DAO dissolved by its owner (terminal)",
+                category: "terminal",
+            },
+        },
     },
     initialState: "ACTIVE",
     transitions: [
@@ -89,7 +114,7 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "ACTIVE",
             eventName: "execute",
-            guard: { "===": [{ var: "event.agent" }, { var: "state.owner" }] },
+            guard: (0, guards_js_1.signerIsParty)("state.owner"),
             effect: {
                 merge: [
                     { var: "state" },
@@ -102,15 +127,23 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
                                         id: { var: "event.actionId" },
                                         type: { var: "event.actionType" },
                                         payload: { var: "event.payload" },
-                                        executedAt: { var: "$timestamp" },
+                                        executedAt: { var: "$ordinal" },
                                     },
                                 ],
                             ],
                         },
+                        // A3 fix: transition-level `emits` is dropped by the chain; emit from INSIDE the effect
+                        // under the reserved `_emit` key (extracted as an EmittedEvent, stripped from state).
+                        _emit: [
+                            {
+                                name: "action_executed",
+                                data: { actionId: { var: "event.actionId" } },
+                                destination: "external",
+                            },
+                        ],
                     },
                 ],
             },
-            emits: [{ event: "action_executed", to: "external" }],
             dependencies: [],
         },
         // ACTIVE → TRANSFERRING: transfer_ownership (owner only)
@@ -118,13 +151,13 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "TRANSFERRING",
             eventName: "transfer_ownership",
-            guard: { "===": [{ var: "event.agent" }, { var: "state.owner" }] },
+            guard: (0, guards_js_1.signerIsParty)("state.owner"),
             effect: {
                 merge: [
                     { var: "state" },
                     {
                         pendingOwner: { var: "event.newOwner" },
-                        transferInitiatedAt: { var: "$timestamp" },
+                        transferInitiatedAt: { var: "$ordinal" },
                     },
                 ],
             },
@@ -135,7 +168,7 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "TRANSFERRING",
             to: "ACTIVE",
             eventName: "accept_ownership",
-            guard: { "===": [{ var: "event.agent" }, { var: "state.pendingOwner" }] },
+            guard: (0, guards_js_1.signerIsParty)("state.pendingOwner"),
             effect: {
                 merge: [
                     { var: "state" },
@@ -150,15 +183,23 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
                                     {
                                         from: { var: "state.owner" },
                                         to: { var: "state.pendingOwner" },
-                                        at: { var: "$timestamp" },
+                                        at: { var: "$ordinal" },
                                     },
                                 ],
                             ],
                         },
+                        // A3 fix: transition-level `emits` is dropped by the chain; emit from INSIDE the effect
+                        // under the reserved `_emit` key (extracted as an EmittedEvent, stripped from state).
+                        _emit: [
+                            {
+                                name: "ownership_transferred",
+                                data: { var: "event" },
+                                destination: "Identity",
+                            },
+                        ],
                     },
                 ],
             },
-            emits: [{ event: "ownership_transferred", to: "Identity" }],
             dependencies: [],
         },
         // TRANSFERRING → ACTIVE: cancel_transfer (owner only)
@@ -166,7 +207,7 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "TRANSFERRING",
             to: "ACTIVE",
             eventName: "cancel_transfer",
-            guard: { "===": [{ var: "event.agent" }, { var: "state.owner" }] },
+            guard: (0, guards_js_1.signerIsParty)("state.owner"),
             effect: {
                 merge: [
                     { var: "state" },
@@ -183,12 +224,12 @@ exports.daoSingleDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "DISSOLVED",
             eventName: "dissolve",
-            guard: { "===": [{ var: "event.agent" }, { var: "state.owner" }] },
+            guard: (0, guards_js_1.signerIsParty)("state.owner"),
             effect: {
                 merge: [
                     { var: "state" },
                     {
-                        dissolvedAt: { var: "$timestamp" },
+                        dissolvedAt: { var: "$ordinal" },
                         status: "DISSOLVED",
                     },
                 ],

package/dist/cjs/apps/governance/state-machines/dao-token.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.daoTokenDef = void 0;
 const fiber_app_js_1 = require("../../../schema/fiber-app.js");
+const guards_js_1 = require("../../../schema/guards.js");
 /**
  * Token-weighted voting. Voting power proportional to token holdings.
  */
@@ -128,10 +129,42 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
         },
     },
     states: {
-        ACTIVE: { id: "ACTIVE", isFinal: false, metadata: null },
-        VOTING: { id: "VOTING", isFinal: false, metadata: null },
-        QUEUED: { id: "QUEUED", isFinal: false, metadata: null },
-        DISSOLVED: { id: "DISSOLVED", isFinal: true, metadata: null },
+        ACTIVE: {
+            id: "ACTIVE",
+            isFinal: false,
+            metadata: {
+                label: "Active",
+                description: "DAO is idle and ready to accept a proposal",
+                category: "initial",
+            },
+        },
+        VOTING: {
+            id: "VOTING",
+            isFinal: false,
+            metadata: {
+                label: "Voting",
+                description: "Token holders are voting on the active proposal",
+                category: "pending",
+            },
+        },
+        QUEUED: {
+            id: "QUEUED",
+            isFinal: false,
+            metadata: {
+                label: "Queued",
+                description: "Passed proposal queued in timelock before execution",
+                category: "pending",
+            },
+        },
+        DISSOLVED: {
+            id: "DISSOLVED",
+            isFinal: true,
+            metadata: {
+                label: "Dissolved",
+                description: "Token DAO dissolved (terminal)",
+                category: "terminal",
+            },
+        },
     },
     initialState: "ACTIVE",
     transitions: [
@@ -140,10 +173,18 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "VOTING",
             eventName: "propose",
+            // S1/A2 coupled fix: a CHAIN-VERIFIED signer must hold >= proposalThreshold
+            // tokens. Iterate proofs[].address and read each balance via `get` (getKey is
+            // not a JLVM opcode); never trust the forgeable event.agent for the lookup.
             guard: {
-                ">=": [
-                    { getKey: [{ var: "state.balances" }, { var: "event.agent" }] },
-                    { var: "state.proposalThreshold" },
+                some: [
+                    { map: [{ var: "proofs" }, { var: "address" }] },
+                    {
+                        ">=": [
+                            { get: [{ var: "state.balances" }, { var: "" }] },
+                            { var: "state.proposalThreshold" },
+                        ],
+                    },
                 ],
             },
             effect: {
@@ -157,9 +198,9 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                             actionType: { var: "event.actionType" },
                             payload: { var: "event.payload" },
                             proposer: { var: "event.agent" },
-                            proposedAt: { var: "$timestamp" },
+                            proposedAt: { var: "$ordinal" },
                             votingEndsAt: {
-                                "+": [{ var: "$timestamp" }, { var: "state.votingPeriodMs" }],
+                                "+": [{ var: "$ordinal" }, { var: "state.votingPeriodMs" }],
                             },
                             snapshotBlock: { var: "event.snapshotBlock" },
                         },
@@ -174,26 +215,28 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "VOTING",
             to: "VOTING",
             eventName: "vote",
+            // S1+A2 coupled fix: bind event.agent to a verified signer (actorIsSigner) so the
+            // balance lookup, the no-double-vote check, and the voters write below all key on the
+            // CHAIN-VERIFIED actor — never a forgeable claim. getKey→get (value), getKey→has
+            // (presence), setKey→set are the rc.5 map opcodes (getKey/setKey do not exist).
             guard: {
                 and: [
+                    (0, guards_js_1.actorIsSigner)(),
                     {
                         ">": [
-                            { getKey: [{ var: "state.balances" }, { var: "event.agent" }] },
+                            { get: [{ var: "state.balances" }, { var: "event.agent" }] },
                             0,
                         ],
                     },
                     {
                         "!": [
                             {
-                                getKey: [{ var: "state.votes.voters" }, { var: "event.agent" }],
+                                has: [{ var: "state.votes.voters" }, { var: "event.agent" }],
                             },
                         ],
                     },
                     {
-                        "<=": [
-                            { var: "$timestamp" },
-                            { var: "state.proposal.votingEndsAt" },
-                        ],
+                        "<=": [{ var: "$ordinal" }, { var: "state.proposal.votingEndsAt" }],
                     },
                 ],
             },
@@ -212,7 +255,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                                 "+": [
                                                     { var: "state.votes.for" },
                                                     {
-                                                        getKey: [
+                                                        get: [
                                                             { var: "state.balances" },
                                                             { var: "event.agent" },
                                                         ],
@@ -226,7 +269,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                                 "+": [
                                                     { var: "state.votes.against" },
                                                     {
-                                                        getKey: [
+                                                        get: [
                                                             { var: "state.balances" },
                                                             { var: "event.agent" },
                                                         ],
@@ -239,7 +282,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                                 "+": [
                                                     { var: "state.votes.abstain" },
                                                     {
-                                                        getKey: [
+                                                        get: [
                                                             { var: "state.balances" },
                                                             { var: "event.agent" },
                                                         ],
@@ -251,18 +294,18 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                 },
                                 {
                                     voters: {
-                                        setKey: [
+                                        set: [
                                             { var: "state.votes.voters" },
                                             { var: "event.agent" },
                                             {
                                                 vote: { var: "event.vote" },
                                                 weight: {
-                                                    getKey: [
+                                                    get: [
                                                         { var: "state.balances" },
                                                         { var: "event.agent" },
                                                     ],
                                                 },
-                                                votedAt: { var: "$timestamp" },
+                                                votedAt: { var: "$ordinal" },
                                             },
                                         ],
                                     },
@@ -282,10 +325,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             guard: {
                 and: [
                     {
-                        ">": [
-                            { var: "$timestamp" },
-                            { var: "state.proposal.votingEndsAt" },
-                        ],
+                        ">": [{ var: "$ordinal" }, { var: "state.proposal.votingEndsAt" }],
                     },
                     { ">": [{ var: "state.votes.for" }, { var: "state.votes.against" }] },
                     {
@@ -310,9 +350,9 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                             merge: [
                                 { var: "state.proposal" },
                                 {
-                                    queuedAt: { var: "$timestamp" },
+                                    queuedAt: { var: "$ordinal" },
                                     executableAt: {
-                                        "+": [{ var: "$timestamp" }, { var: "state.timelockMs" }],
+                                        "+": [{ var: "$ordinal" }, { var: "state.timelockMs" }],
                                     },
                                 },
                             ],
@@ -328,7 +368,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             to: "ACTIVE",
             eventName: "execute",
             guard: {
-                ">=": [{ var: "$timestamp" }, { var: "state.proposal.executableAt" }],
+                ">=": [{ var: "$ordinal" }, { var: "state.proposal.executableAt" }],
             },
             effect: {
                 merge: [
@@ -343,7 +383,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                             { var: "state.proposal" },
                                             {
                                                 votes: { var: "state.votes" },
-                                                executedAt: { var: "$timestamp" },
+                                                executedAt: { var: "$ordinal" },
                                             },
                                         ],
                                     },
@@ -352,10 +392,18 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                         },
                         proposal: null,
                         votes: null,
+                        // A3 fix: transition-level `emits` is dropped by the chain; emit from INSIDE the effect
+                        // under the reserved `_emit` key (extracted as an EmittedEvent, stripped from state).
+                        _emit: [
+                            {
+                                name: "proposal_executed",
+                                data: { proposalId: { var: "state.proposal.id" } },
+                                destination: "external",
+                            },
+                        ],
                     },
                 ],
             },
-            emits: [{ event: "proposal_executed", to: "external" }],
             dependencies: [],
         },
         // VOTING → ACTIVE: reject (voting ended, failed quorum or for <= against)
@@ -366,10 +414,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             guard: {
                 and: [
                     {
-                        ">": [
-                            { var: "$timestamp" },
-                            { var: "state.proposal.votingEndsAt" },
-                        ],
+                        ">": [{ var: "$ordinal" }, { var: "state.proposal.votingEndsAt" }],
                     },
                     {
                         or: [
@@ -408,7 +453,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                             { var: "state.proposal" },
                                             {
                                                 votes: { var: "state.votes" },
-                                                rejectedAt: { var: "$timestamp" },
+                                                rejectedAt: { var: "$ordinal" },
                                             },
                                         ],
                                     },
@@ -427,9 +472,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "QUEUED",
             to: "ACTIVE",
             eventName: "cancel",
-            guard: {
-                "===": [{ var: "event.agent" }, { var: "state.proposal.proposer" }],
-            },
+            guard: (0, guards_js_1.signerIsParty)("state.proposal.proposer"),
             effect: {
                 merge: [
                     { var: "state" },
@@ -441,7 +484,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                                     {
                                         merge: [
                                             { var: "state.proposal" },
-                                            { cancelledAt: { var: "$timestamp" } },
+                                            { cancelledAt: { var: "$ordinal" } },
                                         ],
                                     },
                                 ],
@@ -459,10 +502,17 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "ACTIVE",
             eventName: "delegate",
+            // S1+A2: bind event.agent to a verified signer so the delegation is written under the
+            // CHAIN-VERIFIED delegator's key (set), keyed on the same actor whose balance is checked (get).
             guard: {
-                ">": [
-                    { getKey: [{ var: "state.balances" }, { var: "event.agent" }] },
-                    0,
+                and: [
+                    (0, guards_js_1.actorIsSigner)(),
+                    {
+                        ">": [
+                            { get: [{ var: "state.balances" }, { var: "event.agent" }] },
+                            0,
+                        ],
+                    },
                 ],
             },
             effect: {
@@ -470,7 +520,7 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
                     { var: "state" },
                     {
                         delegations: {
-                            setKey: [
+                            set: [
                                 { var: "state.delegations" },
                                 { var: "event.agent" },
                                 { var: "event.delegateTo" },
@@ -486,13 +536,21 @@ exports.daoTokenDef = (0, fiber_app_js_1.defineFiberApp)({
             from: "ACTIVE",
             to: "ACTIVE",
             eventName: "undelegate",
-            guard: { getKey: [{ var: "state.delegations" }, { var: "event.agent" }] },
+            // S1+A2: bind event.agent to a verified signer; presence via has, removal via unset (the rc.5
+            // map opcodes — getKey/deleteKey do not exist). Only the verified delegator can clear their own
+            // delegation.
+            guard: {
+                and: [
+                    (0, guards_js_1.actorIsSigner)(),
+                    { has: [{ var: "state.delegations" }, { var: "event.agent" }] },
+                ],
+            },
             effect: {
                 merge: [
                     { var: "state" },
                     {
                         delegations: {
-                            deleteKey: [{ var: "state.delegations" }, { var: "event.agent" }],
+                            unset: [{ var: "state.delegations" }, { var: "event.agent" }],
                         },
                     },
                 ],