@ottochain/sdk 2.4.0 → 2.5.0

package/dist/cjs/apps/compute/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Compute Application — bare computation substrates.
+ *
+ * Turing-complete JLVM substrates with no parties, assets, or governance: pure
+ * in-place state evolution. The flagship is `rule110`, an in-place Rule-110
+ * cellular automaton that proves the account layer is Turing-complete.
+ *
+ * @example
+ * ```typescript
+ * import { getComputeDefinition, COMPUTE_DEFINITIONS } from '@ottochain/sdk/apps/compute';
+ *
+ * const rule110Def = getComputeDefinition('rule110');
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPUTE_DEFINITIONS = exports.computeRule110Def = void 0;
+exports.getComputeDefinition = getComputeDefinition;
+const index_js_1 = require("./state-machines/index.js");
+Object.defineProperty(exports, "computeRule110Def", { enumerable: true, get: function () { return index_js_1.computeRule110Def; } });
+/** All compute (bare-computation) state machine definitions. */
+exports.COMPUTE_DEFINITIONS = {
+    rule110: index_js_1.computeRule110Def,
+};
+/**
+ * Get a compute state machine definition by type.
+ * @param type - 'rule110' (default).
+ */
+function getComputeDefinition(type = 'rule110') {
+    return exports.COMPUTE_DEFINITIONS[type];
+}

package/dist/cjs/apps/compute/state-machines/compute-rule110.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRule110Def = void 0;
+const fiber_app_js_1 = require("../../../schema/fiber-app.js");
+/**
+ * Rule-110 cellular automaton — an in-place, Turing-complete JLVM substrate.
+ *
+ * Each `step` event advances ONE CA generation in place:
+ *   next[i] = R110(tape[i-1], tape[i], tape[i+1])
+ * with fixed-0 boundaries, computed as a JLVM `map` over a STORED index array
+ * (`idx`) — no bitwise ops, no spawn, no zip. The fiber loops RUNNING → RUNNING;
+ * the chain of transitions IS the Turing-machine tape-head.
+ *
+ * Rule 110: out = 1 iff p ∈ {1,2,3,5,6}, where p = 4·left + 2·center + right.
+ *
+ * THE INLINED-CELL CONSTRAINT (do not "simplify" with `let`)
+ * ---------------------------------------------------------
+ * Inside `map`, a primitive element is overlaid into the eval context, so
+ * `{var:""}` coerces to the element int ONLY in arithmetic position. Opening a
+ * `let` scope over the element makes `{var:""}` resolve to the whole context
+ * object (`{"tag":"map"}`) and any `cat` on it throws `JsonLogicRuntimeError`.
+ * Therefore the per-cell predicate P is fully INLINED at each of the five `==`
+ * comparison sites (P appears 5×; each neighbour read `nb` reads the tape once
+ * per occurrence). This is the only form that works inside `map`. It is built
+ * programmatically below to avoid hand-duplicating P, but it expands to the
+ * inlined AST — NOT a `let`-form.
+ *
+ * Neighbour access uses a computed `var` PATH with a null-default boundary:
+ *   nb(off) = { var: [ { cat: ["state.tape.", off] }, 0 ] }
+ * An out-of-bounds index (-1 or N) resolves to the default `0` (fixed-0
+ * boundary), so `tape`/`idx` stay exactly length N forever.
+ *
+ * Verified end-to-end against `@constellation-network/metagraph-sdk-jlvm@1.8.0-rc.5`:
+ * the effect reproduces the canonical left-growing Rule-110 fractal exactly,
+ * `idx` is byte-identical across every generation, and the unbounded/bounded
+ * guard halts at `gen == maxGen`.
+ */
+// nb(off): read tape at element-relative offset, fixed-0 boundary via null-default.
+const nb = (off) => ({
+    var: [{ cat: ['state.tape.', off] }, 0],
+});
+// P = 4·left + 2·center + right  (element {var:""} is the cell index i).
+const P = {
+    '+': [{ '*': [4, nb({ '-': [{ var: '' }, 1] })] }, { '*': [2, nb({ var: '' })] }, nb({ '+': [{ var: '' }, 1] })],
+};
+// CELL: 1 iff P ∈ {1,2,3,5,6}, else 0. P is INLINED at each `==` site (B1: never
+// `let` over the map element). Built from the rule-110 truth set programmatically.
+const CELL = {
+    if: [{ or: [1, 2, 3, 5, 6].map((k) => ({ '==': [P, k] })) }, 1, 0],
+};
+/**
+ * Rule-110 cellular-automaton fiber definition.
+ *
+ * Trust model: PUBLIC / PERMISSIONLESS / pure compute. No assets, no parties,
+ * no owner — anyone may submit `step`. The DoS surface is bounded by per-event
+ * gas/fee (~987 gas/cell) and the optional `maxGen` halt bound (absent ⇒
+ * unbounded; runs until fees stop).
+ */
+exports.computeRule110Def = (0, fiber_app_js_1.defineFiberApp)({
+    metadata: {
+        name: 'ComputeRule110',
+        app: 'compute',
+        type: 'rule110',
+        version: '1.0.0',
+        description: 'In-place Rule-110 cellular automaton — a Turing-complete substrate. Each ' +
+            '`step` advances one generation: next[i]=R110(tape[i-1],tape[i],tape[i+1]) ' +
+            'with fixed-0 boundaries, as a JLVM map over a stored index array (no ' +
+            'bitwise, no spawn, no zip).',
+    },
+    createSchema: {
+        // maxGen is NOT required: absent ⇒ unbounded (the step guard uses `missing`).
+        required: ['tape', 'idx'],
+        properties: {
+            tape: {
+                type: 'array',
+                items: { type: 'integer' },
+                description: '0/1 CA row (length N).',
+            },
+            idx: {
+                type: 'array',
+                items: { type: 'integer' },
+                immutable: true,
+                description: 'Monotone index array [0..N-1]; REQUIRED (no range/iota opcode). ' +
+                    'Never mutated — the effect preserves it across every generation.',
+            },
+            gen: {
+                type: 'integer',
+                default: 0,
+                description: 'Generation counter (TM step count).',
+            },
+            maxGen: {
+                type: 'integer',
+                description: 'Optional halt bound; absent ⇒ unbounded.',
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            tape: { type: 'array', items: { type: 'integer' }, computed: true },
+            idx: { type: 'array', items: { type: 'integer' }, immutable: true },
+            gen: { type: 'integer', computed: true },
+            maxGen: { type: 'integer' },
+            status: { type: 'string', computed: true },
+        },
+    },
+    eventSchemas: {
+        step: { description: 'Advance one CA generation in place.' },
+        halt: { description: 'Terminate once maxGen is reached (gated by gen >= maxGen).' },
+    },
+    states: {
+        RUNNING: {
+            id: 'RUNNING',
+            isFinal: false,
+            metadata: {
+                label: 'Running',
+                description: 'CA evolving; each step = one generation.',
+                category: 'active',
+            },
+        },
+        HALTED: {
+            id: 'HALTED',
+            isFinal: true,
+            metadata: {
+                label: 'Halted',
+                description: 'maxGen reached; terminal.',
+                category: 'terminal',
+            },
+        },
+    },
+    initialState: 'RUNNING',
+    transitions: [
+        {
+            // One `step` = one generation. Loops in place (the TM tape-head).
+            from: 'RUNNING',
+            to: 'RUNNING',
+            eventName: 'step',
+            // Unbounded when maxGen is absent (`missing` → true); else gate on gen < maxGen.
+            guard: {
+                or: [{ missing: ['state.maxGen'] }, { '<': [{ var: 'state.gen' }, { var: 'state.maxGen' }] }],
+            },
+            // Effect result IS the new stateData: merge[state, overrides] preserves
+            // idx/maxGen and overwrites tape/gen.
+            effect: {
+                merge: [
+                    { var: 'state' },
+                    {
+                        tape: { map: [{ var: 'state.idx' }, CELL] },
+                        gen: { '+': [{ var: 'state.gen' }, 1] },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            // halt is rejected until exhaustion: gen >= maxGen.
+            from: 'RUNNING',
+            to: 'HALTED',
+            eventName: 'halt',
+            guard: { '>=': [{ var: 'state.gen' }, { var: 'state.maxGen' }] },
+            effect: { merge: [{ var: 'state' }, { status: 'halted' }] },
+            dependencies: [],
+        },
+    ],
+});

package/dist/cjs/apps/compute/state-machines/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Compute (bare-computation) state machine definitions.
+ * Re-exports from TypeScript definition files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRule110Def = void 0;
+var compute_rule110_js_1 = require("./compute-rule110.js");
+Object.defineProperty(exports, "computeRule110Def", { enumerable: true, get: function () { return compute_rule110_js_1.computeRule110Def; } });

package/dist/cjs/apps/contracts/index.js

@@ -59,7 +59,7 @@ exports.CONTRACTS_DEFINITIONS = {
  * Get a contract state machine definition by type.
  * @param type - 'universal' | 'agreement' | 'escrow' (default: 'agreement')
  */
-function getContractDefinition(type = "agreement") {
+function getContractDefinition(type = 'agreement') {
     return exports.CONTRACTS_DEFINITIONS[type];
 }
 /** @deprecated Use getContractDefinition('escrow') */

package/dist/cjs/apps/contracts/state-machines/contract-agreement.js

@@ -8,203 +8,194 @@ const guards_js_1 = require("../../../schema/guards.js");
  */
 exports.contractAgreementDef = (0, fiber_app_js_1.defineFiberApp)({
     metadata: {
-        name: "ContractAgreement",
-        app: "contracts",
-        type: "agreement",
-        version: "1.0.0",
-        description: "Two-party agreement with mutual completion attestation and dispute resolution",
+        name: 'ContractAgreement',
+        app: 'contracts',
+        type: 'agreement',
+        version: '1.0.0',
+        description: 'Two-party agreement with mutual completion attestation and dispute resolution',
         crossReferences: {
             proposerIdentityId: {
-                machine: "identity-agent",
-                field: "proposer",
+                machine: 'identity-agent',
+                field: 'proposer',
                 description: "Links to proposer's AgentIdentity fiber",
             },
             counterpartyIdentityId: {
-                machine: "identity-agent",
-                field: "counterparty",
+                machine: 'identity-agent',
+                field: 'counterparty',
                 description: "Links to counterparty's AgentIdentity fiber",
             },
             escrowId: {
-                machine: "contract-escrow",
-                field: "escrowId",
-                description: "Links to Escrow if payment is escrowed",
+                machine: 'contract-escrow',
+                field: 'escrowId',
+                description: 'Links to Escrow if payment is escrowed',
             },
             arbitrationPoolId: {
-                machine: "arbitration-pool",
-                field: "arbitrationPoolId",
-                description: "Links to ArbitrationPool for dispute resolution",
+                machine: 'arbitration-pool',
+                field: 'arbitrationPoolId',
+                description: 'Links to ArbitrationPool for dispute resolution',
             },
         },
     },
     createSchema: {
-        required: ["proposer", "counterparty", "arbitrator"],
+        required: ['proposer', 'counterparty', 'arbitrator'],
         properties: {
             proposer: {
-                type: "address",
-                description: "DAG address of the proposer",
+                type: 'address',
+                description: 'DAG address of the proposer',
                 immutable: true,
             },
             counterparty: {
-                type: "address",
-                description: "DAG address of the counterparty",
+                type: 'address',
+                description: 'DAG address of the counterparty',
                 immutable: true,
             },
             arbitrator: {
-                type: "address",
-                description: "DAG address of the arbitrator authorized to resolve a dispute",
+                type: 'address',
+                description: 'DAG address of the arbitrator authorized to resolve a dispute',
                 immutable: true,
             },
         },
     },
     stateSchema: {
         properties: {
-            status: { type: "string" },
-            proposer: { type: "address" },
-            counterparty: { type: "address" },
-            arbitrator: { type: "address", immutable: true },
-            completions: { type: "array" },
-            acceptedAt: { type: "integer", nullable: true },
-            rejectedAt: { type: "integer", nullable: true },
-            rejectReason: { type: "string", nullable: true },
-            cancelledAt: { type: "integer", nullable: true },
-            completedAt: { type: "integer", nullable: true },
-            disputedAt: { type: "integer", nullable: true },
-            disputeReason: { type: "string", nullable: true },
-            disputedBy: { type: "address", nullable: true },
-            resolvedAt: { type: "integer", nullable: true },
-            resolution: { type: "string", nullable: true },
-            rulingId: { type: "string", nullable: true },
+            status: { type: 'string' },
+            proposer: { type: 'address' },
+            counterparty: { type: 'address' },
+            arbitrator: { type: 'address', immutable: true },
+            completions: { type: 'array' },
+            acceptedAt: { type: 'integer', nullable: true },
+            rejectedAt: { type: 'integer', nullable: true },
+            rejectReason: { type: 'string', nullable: true },
+            cancelledAt: { type: 'integer', nullable: true },
+            completedAt: { type: 'integer', nullable: true },
+            disputedAt: { type: 'integer', nullable: true },
+            disputeReason: { type: 'string', nullable: true },
+            disputedBy: { type: 'address', nullable: true },
+            resolvedAt: { type: 'integer', nullable: true },
+            resolution: { type: 'string', nullable: true },
+            rulingId: { type: 'string', nullable: true },
         },
     },
     eventSchemas: {
         accept: {},
-        reject: { properties: { reason: { type: "string" } } },
+        reject: { properties: { reason: { type: 'string' } } },
         cancel: {},
-        submit_completion: { properties: { proof: { type: "string" } } },
+        submit_completion: { properties: { proof: { type: 'string' } } },
         finalize: {},
-        dispute: { properties: { reason: { type: "string" } } },
+        dispute: { properties: { reason: { type: 'string' } } },
         resolve: {
             properties: {
-                resolution: { type: "string" },
-                rulingId: { type: "string", nullable: true },
+                resolution: { type: 'string' },
+                rulingId: { type: 'string', nullable: true },
             },
         },
     },
     states: {
         PROPOSED: {
-            id: "PROPOSED",
+            id: 'PROPOSED',
             isFinal: false,
             metadata: {
-                label: "Proposed",
-                description: "Agreement proposed; awaiting the counterparty",
-                category: "initial",
+                label: 'Proposed',
+                description: 'Agreement proposed; awaiting the counterparty',
+                category: 'initial',
             },
         },
         ACTIVE: {
-            id: "ACTIVE",
+            id: 'ACTIVE',
             isFinal: false,
             metadata: {
-                label: "Active",
-                description: "Agreement accepted and in effect",
-                category: "active",
+                label: 'Active',
+                description: 'Agreement accepted and in effect',
+                category: 'active',
             },
         },
         COMPLETED: {
-            id: "COMPLETED",
+            id: 'COMPLETED',
             isFinal: true,
             metadata: {
-                label: "Completed",
-                description: "Agreement completed and attested (terminal)",
-                category: "terminal",
+                label: 'Completed',
+                description: 'Agreement completed and attested (terminal)',
+                category: 'terminal',
             },
         },
         DISPUTED: {
-            id: "DISPUTED",
+            id: 'DISPUTED',
             isFinal: false,
             metadata: {
-                label: "Disputed",
-                description: "A party has raised a dispute; awaiting resolution",
-                category: "pending",
+                label: 'Disputed',
+                description: 'A party has raised a dispute; awaiting resolution',
+                category: 'pending',
             },
         },
         REJECTED: {
-            id: "REJECTED",
+            id: 'REJECTED',
             isFinal: true,
             metadata: {
-                label: "Rejected",
-                description: "Proposal rejected by the counterparty (terminal)",
-                category: "terminal",
+                label: 'Rejected',
+                description: 'Proposal rejected by the counterparty (terminal)',
+                category: 'terminal',
             },
         },
         CANCELLED: {
-            id: "CANCELLED",
+            id: 'CANCELLED',
             isFinal: true,
             metadata: {
-                label: "Cancelled",
-                description: "Agreement cancelled before completion (terminal)",
-                category: "terminal",
+                label: 'Cancelled',
+                description: 'Agreement cancelled before completion (terminal)',
+                category: 'terminal',
             },
         },
     },
-    initialState: "PROPOSED",
+    initialState: 'PROPOSED',
     transitions: [
         {
-            from: "PROPOSED",
-            to: "ACTIVE",
-            eventName: "accept",
-            guard: (0, guards_js_1.signerIsParty)("state.counterparty"),
+            from: 'PROPOSED',
+            to: 'ACTIVE',
+            eventName: 'accept',
+            guard: (0, guards_js_1.signerIsParty)('state.counterparty'),
             effect: {
-                merge: [
-                    { var: "state" },
-                    { status: "ACTIVE", acceptedAt: { var: "$ordinal" } },
-                ],
+                merge: [{ var: 'state' }, { status: 'ACTIVE', acceptedAt: { var: '$ordinal' } }],
             },
             dependencies: [],
         },
         {
-            from: "PROPOSED",
-            to: "REJECTED",
-            eventName: "reject",
-            guard: (0, guards_js_1.signerIsParty)("state.counterparty"),
+            from: 'PROPOSED',
+            to: 'REJECTED',
+            eventName: 'reject',
+            guard: (0, guards_js_1.signerIsParty)('state.counterparty'),
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "REJECTED",
-                        rejectedAt: { var: "$ordinal" },
-                        rejectReason: { var: "event.reason" },
+                        status: 'REJECTED',
+                        rejectedAt: { var: '$ordinal' },
+                        rejectReason: { var: 'event.reason' },
                     },
                 ],
             },
             dependencies: [],
         },
         {
-            from: "PROPOSED",
-            to: "CANCELLED",
-            eventName: "cancel",
-            guard: (0, guards_js_1.signerIsParty)("state.proposer"),
+            from: 'PROPOSED',
+            to: 'CANCELLED',
+            eventName: 'cancel',
+            guard: (0, guards_js_1.signerIsParty)('state.proposer'),
             effect: {
-                merge: [
-                    { var: "state" },
-                    { status: "CANCELLED", cancelledAt: { var: "$ordinal" } },
-                ],
+                merge: [{ var: 'state' }, { status: 'CANCELLED', cancelledAt: { var: '$ordinal' } }],
             },
             dependencies: [],
         },
         {
-            from: "ACTIVE",
-            to: "ACTIVE",
-            eventName: "submit_completion",
+            from: 'ACTIVE',
+            to: 'ACTIVE',
+            eventName: 'submit_completion',
             guard: {
                 and: [
-                    (0, guards_js_1.signerIsAnyParty)(["state.proposer", "state.counterparty"]),
+                    (0, guards_js_1.signerIsAnyParty)(['state.proposer', 'state.counterparty']),
                     {
-                        "!": [
+                        '!': [
                             {
-                                in: [
-                                    { var: "event.agent" },
-                                    { map: [{ var: "state.completions" }, { var: "agent" }] },
-                                ],
+                                in: [{ var: 'event.agent' }, { map: [{ var: 'state.completions' }, { var: 'agent' }] }],
                             },
                         ],
                     },
@@ -212,16 +203,16 @@ exports.contractAgreementDef = (0, fiber_app_js_1.defineFiberApp)({
             },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
                         completions: {
                             cat: [
-                                { var: "state.completions" },
+                                { var: 'state.completions' },
                                 [
                                     {
-                                        agent: { var: "event.agent" },
-                                        proof: { var: "event.proof" },
-                                        submittedAt: { var: "$ordinal" },
+                                        agent: { var: 'event.agent' },
+                                        proof: { var: 'event.proof' },
+                                        submittedAt: { var: '$ordinal' },
                                     },
                                 ],
                             ],
@@ -232,66 +223,56 @@ exports.contractAgreementDef = (0, fiber_app_js_1.defineFiberApp)({
             dependencies: [],
         },
         {
-            from: "ACTIVE",
-            to: "COMPLETED",
-            eventName: "finalize",
-            guard: { ">=": [{ length: [{ var: "state.completions" }] }, 2] },
+            from: 'ACTIVE',
+            to: 'COMPLETED',
+            eventName: 'finalize',
+            guard: { '>=': [{ length: [{ var: 'state.completions' }] }, 2] },
             effect: {
-                merge: [
-                    { var: "state" },
-                    { status: "COMPLETED", completedAt: { var: "$ordinal" } },
-                ],
+                merge: [{ var: 'state' }, { status: 'COMPLETED', completedAt: { var: '$ordinal' } }],
             },
             dependencies: [],
         },
         {
-            from: "ACTIVE",
-            to: "DISPUTED",
-            eventName: "dispute",
-            guard: (0, guards_js_1.signerIsAnyParty)(["state.proposer", "state.counterparty"]),
+            from: 'ACTIVE',
+            to: 'DISPUTED',
+            eventName: 'dispute',
+            guard: (0, guards_js_1.signerIsAnyParty)(['state.proposer', 'state.counterparty']),
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "DISPUTED",
-                        disputedAt: { var: "$ordinal" },
-                        disputeReason: { var: "event.reason" },
-                        disputedBy: { var: "event.agent" },
+                        status: 'DISPUTED',
+                        disputedAt: { var: '$ordinal' },
+                        disputeReason: { var: 'event.reason' },
+                        disputedBy: { var: 'event.agent' },
                     },
                 ],
             },
             dependencies: [],
         },
         {
-            from: "DISPUTED",
-            to: "COMPLETED",
-            eventName: "resolve",
+            from: 'DISPUTED',
+            to: 'COMPLETED',
+            eventName: 'resolve',
             // authority gate — an ARBITER/SLASHER attestation check layers on additively when the identity registry lands (see docs/design/app-hardening-identity-integration.md §4.2)
             guard: {
                 or: [
-                    (0, guards_js_1.signerIsParty)("state.arbitrator"),
+                    (0, guards_js_1.signerIsParty)('state.arbitrator'),
                     {
-                        and: [
-                            (0, guards_js_1.signerIsParty)("state.proposer"),
-                            (0, guards_js_1.signerIsParty)("state.counterparty"),
-                        ],
+                        and: [(0, guards_js_1.signerIsParty)('state.proposer'), (0, guards_js_1.signerIsParty)('state.counterparty')],
                     },
                 ],
             },
             effect: {
                 merge: [
-                    { var: "state" },
+                    { var: 'state' },
                     {
-                        status: "COMPLETED",
-                        resolvedAt: { var: "$ordinal" },
-                        resolution: { var: "event.resolution" },
+                        status: 'COMPLETED',
+                        resolvedAt: { var: '$ordinal' },
+                        resolution: { var: 'event.resolution' },
                         // rulingId is recorded only on the arbitrator-resolved path
                         rulingId: {
-                            if: [
-                                (0, guards_js_1.signerIsParty)("state.arbitrator"),
-                                { var: "event.rulingId" },
-                                null,
-                            ],
+                            if: [(0, guards_js_1.signerIsParty)('state.arbitrator'), { var: 'event.rulingId' }, null],
                         },
                     },
                 ],
@@ -299,15 +280,12 @@ exports.contractAgreementDef = (0, fiber_app_js_1.defineFiberApp)({
             dependencies: [],
         },
         {
-            from: "ACTIVE",
-            to: "CANCELLED",
-            eventName: "cancel",
-            guard: (0, guards_js_1.signerIsAnyParty)(["state.proposer", "state.counterparty"]),
+            from: 'ACTIVE',
+            to: 'CANCELLED',
+            eventName: 'cancel',
+            guard: (0, guards_js_1.signerIsAnyParty)(['state.proposer', 'state.counterparty']),
             effect: {
-                merge: [
-                    { var: "state" },
-                    { status: "CANCELLED", cancelledAt: { var: "$ordinal" } },
-                ],
+                merge: [{ var: 'state' }, { status: 'CANCELLED', cancelledAt: { var: '$ordinal' } }],
             },
             dependencies: [],
         },