@ottochain/sdk 1.1.0 → 1.2.0

package/dist/cjs/apps/oracles/state-machines/oracle.json

@@ -6,52 +6,36 @@
     },
     "states": {
         "UNREGISTERED": {
-            "id": {
-                "value": "UNREGISTERED"
-            },
+            "id": "UNREGISTERED",
             "isFinal": false,
             "metadata": null
         },
         "REGISTERED": {
-            "id": {
-                "value": "REGISTERED"
-            },
+            "id": "REGISTERED",
             "isFinal": false,
             "metadata": null
         },
         "ACTIVE": {
-            "id": {
-                "value": "ACTIVE"
-            },
+            "id": "ACTIVE",
             "isFinal": false,
             "metadata": null
         },
         "SLASHED": {
-            "id": {
-                "value": "SLASHED"
-            },
+            "id": "SLASHED",
             "isFinal": false,
             "metadata": null
         },
         "WITHDRAWN": {
-            "id": {
-                "value": "WITHDRAWN"
-            },
+            "id": "WITHDRAWN",
             "isFinal": true,
             "metadata": null
         }
     },
-    "initialState": {
-        "value": "UNREGISTERED"
-    },
+    "initialState": "UNREGISTERED",
     "transitions": [
         {
-            "from": {
-                "value": "UNREGISTERED"
-            },
-            "to": {
-                "value": "REGISTERED"
-            },
+            "from": "UNREGISTERED",
+            "to": "REGISTERED",
             "eventName": "register",
             "guard": {
                 ">=": [
@@ -95,12 +79,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "REGISTERED"
-            },
-            "to": {
-                "value": "ACTIVE"
-            },
+            "from": "REGISTERED",
+            "to": "ACTIVE",
             "eventName": "activate",
             "guard": {
                 "or": [
@@ -135,12 +115,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "ACTIVE"
-            },
-            "to": {
-                "value": "ACTIVE"
-            },
+            "from": "ACTIVE",
+            "to": "ACTIVE",
             "eventName": "add_stake",
             "guard": {
                 "and": [
@@ -189,12 +165,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "ACTIVE"
-            },
-            "to": {
-                "value": "ACTIVE"
-            },
+            "from": "ACTIVE",
+            "to": "ACTIVE",
             "eventName": "record_resolution",
             "guard": {
                 "var": "event.marketId"
@@ -249,12 +221,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "ACTIVE"
-            },
-            "to": {
-                "value": "SLASHED"
-            },
+            "from": "ACTIVE",
+            "to": "SLASHED",
             "eventName": "slash",
             "guard": {
                 "and": [
@@ -330,12 +298,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "SLASHED"
-            },
-            "to": {
-                "value": "ACTIVE"
-            },
+            "from": "SLASHED",
+            "to": "ACTIVE",
             "eventName": "reactivate",
             "guard": {
                 "and": [
@@ -377,12 +341,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "ACTIVE"
-            },
-            "to": {
-                "value": "WITHDRAWN"
-            },
+            "from": "ACTIVE",
+            "to": "WITHDRAWN",
             "eventName": "withdraw",
             "guard": {
                 "===": [
@@ -413,12 +373,8 @@
             "dependencies": []
         },
         {
-            "from": {
-                "value": "SLASHED"
-            },
-            "to": {
-                "value": "WITHDRAWN"
-            },
+            "from": "SLASHED",
+            "to": "WITHDRAWN",
             "eventName": "withdraw",
             "guard": {
                 "===": [

package/dist/cjs/generated/index.js

@@ -8,7 +8,7 @@
  * @packageDocumentation
  *
  * NOTE — Dual-type architecture:
- * These generated types use proto conventions (FIBER_STATUS_ACTIVE, StateId { value } wrappers).
+ * These generated types use proto conventions (FIBER_STATUS_ACTIVE, plain string StateId).
  * The wire-format REST API types in src/ottochain/types.ts use plain strings ('Active').
  * Both coexist intentionally until PR #89 (Migrate fiber-engine to generated Scala types) merges.
  *

package/dist/cjs/index.js

@@ -29,7 +29,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assert = exports.safeParse = exports.validateKeyPair = exports.validateAddress = exports.validatePublicKey = exports.validatePrivateKey = exports.validate = exports.CompleteContractRequestSchema = exports.AcceptContractRequestSchema = exports.ProposeContractRequestSchema = exports.ContractTermsSchema = exports.PlatformLinkSchema = exports.AgentIdentityRegistrationSchema = exports.TransferParamsSchema = exports.CurrencyTransactionSchema = exports.CurrencyTransactionValueSchema = exports.TransactionReferenceSchema = exports.SignedSchema = exports.SignatureProofSchema = exports.KeyPairSchema = exports.PublicKeySchema = exports.PrivateKeySchema = exports.DagAddressSchema = exports.wrapError = exports.isErrorCode = exports.ErrorCode = exports.TransactionError = exports.SigningError = exports.ValidationError = exports.NetworkError = exports.OttoChainError = void 0;
+exports.MetagraphClient = exports.assert = exports.safeParse = exports.validateKeyPair = exports.validateAddress = exports.validatePublicKey = exports.validatePrivateKey = exports.validate = exports.CompleteContractRequestSchema = exports.AcceptContractRequestSchema = exports.ProposeContractRequestSchema = exports.ContractTermsSchema = exports.PlatformLinkSchema = exports.AgentIdentityRegistrationSchema = exports.TransferParamsSchema = exports.CurrencyTransactionSchema = exports.CurrencyTransactionValueSchema = exports.TransactionReferenceSchema = exports.SignedSchema = exports.SignatureProofSchema = exports.KeyPairSchema = exports.PublicKeySchema = exports.PrivateKeySchema = exports.DagAddressSchema = exports.wrapError = exports.isErrorCode = exports.ErrorCode = exports.TransactionError = exports.SigningError = exports.ValidationError = exports.NetworkError = exports.OttoChainError = void 0;
 // Type aliases for semantic clarity (matches wire format)
 __exportStar(require("./types.js"), exports);
 // Metakit utilities (signing, hashing, HTTP client)
@@ -77,3 +77,6 @@ Object.defineProperty(exports, "assert", { enumerable: true, get: function () {
 __exportStar(require("./errors.js"), exports);
 // Validation schemas and helpers
 __exportStar(require("./validation.js"), exports);
+// Ottochain metagraph client
+var metagraph_client_js_1 = require("./ottochain/metagraph-client.js");
+Object.defineProperty(exports, "MetagraphClient", { enumerable: true, get: function () { return metagraph_client_js_1.MetagraphClient; } });

package/dist/cjs/metakit/index.js

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkError = exports.HttpClient = exports.DataL1Client = exports.CurrencyL1Client = exports.unitsToToken = exports.tokenToUnits = exports.isValidDagAddress = exports.getTransactionReference = exports.hashCurrencyTransaction = exports.encodeCurrencyTransaction = exports.verifyCurrencyTransaction = exports.signCurrencyTransaction = exports.createCurrencyTransactionBatch = exports.createCurrencyTransaction = exports.TOKEN_DECIMALS = exports.isValidPublicKey = exports.isValidPrivateKey = exports.getAddress = exports.getPublicKeyId = exports.getPublicKeyHex = exports.keyPairFromPrivateKey = exports.generateKeyPair = exports.batchSign = exports.addSignature = exports.createSignedObject = exports.verifySignature = exports.verifyHash = exports.verify = exports.signHash = exports.signDataUpdate = exports.sign = exports.decodeDataUpdate = exports.computeDigest = exports.hashData = exports.hashBytes = exports.hash = exports.encodeDataUpdate = exports.toBytes = exports.canonicalize = exports.CONSTELLATION_PREFIX = exports.ALGORITHM = void 0;
+exports.createDataTransactionRequest = exports.createScriptPayload = exports.createStateMachinePayload = exports.getPublicKeyForRegistration = exports.addTransactionSignature = exports.signTransaction = exports.createInvokeScriptPayload = exports.createArchivePayload = exports.createTransitionPayload = exports.NetworkError = exports.HttpClient = exports.DataL1Client = exports.CurrencyL1Client = exports.unitsToToken = exports.tokenToUnits = exports.isValidDagAddress = exports.getTransactionReference = exports.hashCurrencyTransaction = exports.encodeCurrencyTransaction = exports.verifyCurrencyTransaction = exports.signCurrencyTransaction = exports.createCurrencyTransactionBatch = exports.createCurrencyTransaction = exports.TOKEN_DECIMALS = exports.isValidPublicKey = exports.isValidPrivateKey = exports.getAddress = exports.getPublicKeyId = exports.getPublicKeyHex = exports.keyPairFromPrivateKey = exports.generateKeyPair = exports.batchSign = exports.addSignature = exports.createSignedObject = exports.verifySignature = exports.verifyHash = exports.verify = exports.signHash = exports.signDataUpdate = exports.sign = exports.decodeDataUpdate = exports.computeDigest = exports.hashData = exports.hashBytes = exports.hash = exports.encodeDataUpdate = exports.toBytes = exports.canonicalize = exports.CONSTELLATION_PREFIX = exports.ALGORITHM = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "ALGORITHM", { enumerable: true, get: function () { return types_js_1.ALGORITHM; } });
 Object.defineProperty(exports, "CONSTELLATION_PREFIX", { enumerable: true, get: function () { return types_js_1.CONSTELLATION_PREFIX; } });
@@ -72,3 +72,15 @@ Object.defineProperty(exports, "CurrencyL1Client", { enumerable: true, get: func
 Object.defineProperty(exports, "DataL1Client", { enumerable: true, get: function () { return index_js_1.DataL1Client; } });
 Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return index_js_1.HttpClient; } });
 Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return index_js_1.NetworkError; } });
+// Transaction helpers for self-signed mode
+var transaction_js_1 = require("./transaction.js");
+Object.defineProperty(exports, "createTransitionPayload", { enumerable: true, get: function () { return transaction_js_1.createTransitionPayload; } });
+Object.defineProperty(exports, "createArchivePayload", { enumerable: true, get: function () { return transaction_js_1.createArchivePayload; } });
+Object.defineProperty(exports, "createInvokeScriptPayload", { enumerable: true, get: function () { return transaction_js_1.createInvokeScriptPayload; } });
+Object.defineProperty(exports, "signTransaction", { enumerable: true, get: function () { return transaction_js_1.signTransaction; } });
+Object.defineProperty(exports, "addTransactionSignature", { enumerable: true, get: function () { return transaction_js_1.addTransactionSignature; } });
+Object.defineProperty(exports, "getPublicKeyForRegistration", { enumerable: true, get: function () { return transaction_js_1.getPublicKeyForRegistration; } });
+var transaction_js_2 = require("./transaction.js");
+Object.defineProperty(exports, "createStateMachinePayload", { enumerable: true, get: function () { return transaction_js_2.createStateMachinePayload; } });
+Object.defineProperty(exports, "createScriptPayload", { enumerable: true, get: function () { return transaction_js_2.createScriptPayload; } });
+Object.defineProperty(exports, "createDataTransactionRequest", { enumerable: true, get: function () { return transaction_js_2.createDataTransactionRequest; } });

package/dist/cjs/metakit/transaction.js

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * Transaction Helpers for Self-Signed Mode
+ *
+ * These helpers create properly formatted payloads for the bridge's
+ * self-signed mode, where clients sign their own transactions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublicKeyForRegistration = exports.addTransactionSignature = exports.createDataTransactionRequest = exports.signTransaction = exports.createInvokeScriptPayload = exports.createScriptPayload = exports.createArchivePayload = exports.createTransitionPayload = exports.createStateMachinePayload = void 0;
+const sign_js_1 = require("./sign.js");
+const wallet_js_1 = require("./wallet.js");
+/**
+ * Create a new state machine fiber payload.
+ *
+ * @param params - State machine creation parameters
+ * @returns A CreateStateMachine message ready for signing
+ *
+ * @example
+ * ```typescript
+ * const create = createStateMachinePayload({
+ *   fiberId: crypto.randomUUID(),
+ *   definition: {
+ *     states: { CREATED: { on: { activate: 'ACTIVE' } }, ACTIVE: {} },
+ *     initialState: 'CREATED',
+ *   },
+ *   initialData: { owner: myAddress },
+ * });
+ * const signed = await signTransaction(create, privateKey);
+ * ```
+ */
+function createStateMachinePayload(params) {
+    return {
+        CreateStateMachine: {
+            fiberId: params.fiberId,
+            definition: params.definition,
+            initialData: params.initialData ?? {},
+            ...(params.parentFiberId ? { parentFiberId: params.parentFiberId } : {}),
+        },
+    };
+}
+exports.createStateMachinePayload = createStateMachinePayload;
+/**
+ * Create a transition payload ready for signing.
+ *
+ * This creates the exact message structure expected by the metagraph.
+ *
+ * @param params - Transition parameters
+ * @returns A TransitionStateMachine message ready for signing
+ *
+ * @example
+ * ```typescript
+ * const transition = createTransitionPayload({
+ *   fiberId: 'my-fiber-id',
+ *   eventName: 'activate',
+ *   payload: {},
+ *   targetSequenceNumber: 0,
+ * });
+ * ```
+ */
+function createTransitionPayload(params) {
+    return {
+        TransitionStateMachine: {
+            fiberId: params.fiberId,
+            eventName: params.eventName,
+            payload: params.payload ?? {},
+            targetSequenceNumber: params.targetSequenceNumber,
+        },
+    };
+}
+exports.createTransitionPayload = createTransitionPayload;
+/**
+ * Create an archive payload ready for signing.
+ *
+ * @param params - Archive parameters
+ * @returns An ArchiveStateMachine message ready for signing
+ */
+function createArchivePayload(params) {
+    return {
+        ArchiveStateMachine: {
+            fiberId: params.fiberId,
+            targetSequenceNumber: params.targetSequenceNumber,
+        },
+    };
+}
+exports.createArchivePayload = createArchivePayload;
+/**
+ * Create a new script fiber payload.
+ *
+ * Note: `initialState` must be an object or array, NOT a primitive.
+ *
+ * @param params - Script creation parameters
+ * @returns A CreateScript message ready for signing
+ *
+ * @example
+ * ```typescript
+ * const script = createScriptPayload({
+ *   fiberId: crypto.randomUUID(),
+ *   scriptProgram: {
+ *     methods: {
+ *       increment: { "+": [{ var: "state.value" }, 1] },
+ *     },
+ *   },
+ *   initialState: { value: 0 },
+ *   accessControl: { type: 'open' },
+ * });
+ * const signed = await signTransaction(script, privateKey);
+ * ```
+ */
+function createScriptPayload(params) {
+    return {
+        CreateScript: {
+            fiberId: params.fiberId,
+            scriptProgram: params.scriptProgram,
+            initialState: params.initialState ?? null,
+            accessControl: params.accessControl ?? { type: 'open' },
+        },
+    };
+}
+exports.createScriptPayload = createScriptPayload;
+/**
+ * Create an invoke script payload ready for signing.
+ *
+ * @param params - Invoke script parameters
+ * @returns An InvokeScript message ready for signing
+ */
+function createInvokeScriptPayload(params) {
+    return {
+        InvokeScript: {
+            fiberId: params.fiberId,
+            method: params.method,
+            args: params.args ?? {},
+            targetSequenceNumber: params.targetSequenceNumber,
+        },
+    };
+}
+exports.createInvokeScriptPayload = createInvokeScriptPayload;
+/**
+ * Sign a transaction payload for self-signed mode.
+ *
+ * This creates a Signed<T> object with the exact format expected by the bridge's
+ * `/agent/transition` endpoint when using self-signed mode.
+ *
+ * @param message - The message to sign (e.g., from createTransitionPayload)
+ * @param privateKey - The private key in hex format (64 characters)
+ * @returns A signed object ready for submission to the bridge
+ *
+ * @example
+ * ```typescript
+ * import { createTransitionPayload, signTransaction, generateKeyPair } from '@ottochain/sdk';
+ *
+ * const keyPair = generateKeyPair();
+ *
+ * // Create the transition message
+ * const transition = createTransitionPayload({
+ *   fiberId: 'my-fiber-id',
+ *   eventName: 'activate',
+ *   payload: {},
+ *   targetSequenceNumber: 0,
+ * });
+ *
+ * // Sign it
+ * const signedUpdate = await signTransaction(transition, keyPair.privateKey);
+ *
+ * // Submit to bridge
+ * await fetch('https://bridge/agent/transition', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     fiberId: 'my-fiber-id',
+ *     signedUpdate,
+ *   }),
+ * });
+ * ```
+ */
+async function signTransaction(message, privateKey) {
+    const proof = await (0, sign_js_1.signDataUpdate)(message, privateKey);
+    return {
+        value: message,
+        proofs: [proof],
+    };
+}
+exports.signTransaction = signTransaction;
+/**
+ * Wrap a signed transaction in the DataTransactionRequest format
+ * expected by tessellation's DL1 `/data` endpoint.
+ *
+ * @param signed - A signed transaction from signTransaction()
+ * @returns Payload ready for POST to DL1 `/data`
+ *
+ * @example
+ * ```typescript
+ * const transition = createTransitionPayload({ ... });
+ * const signed = await signTransaction(transition, privateKey);
+ * const payload = createDataTransactionRequest(signed);
+ *
+ * // Submit directly to DL1
+ * await fetch('http://dl1-node:9400/data', {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json' },
+ *   body: JSON.stringify(payload),
+ * });
+ * ```
+ */
+function createDataTransactionRequest(signed) {
+    return { data: signed, fee: null };
+}
+exports.createDataTransactionRequest = createDataTransactionRequest;
+/**
+ * Add an additional signature to a signed transaction.
+ *
+ * Use this for multi-signature scenarios where multiple parties
+ * need to sign the same transaction.
+ *
+ * @param signed - The already-signed transaction
+ * @param privateKey - Additional signer's private key
+ * @returns Transaction with additional signature
+ */
+async function addTransactionSignature(signed, privateKey) {
+    const newProof = await (0, sign_js_1.signDataUpdate)(signed.value, privateKey);
+    return {
+        value: signed.value,
+        proofs: [...signed.proofs, newProof],
+    };
+}
+exports.addTransactionSignature = addTransactionSignature;
+/**
+ * Get the public key ID from a private key in the format expected by registration.
+ *
+ * The bridge's self-signed registration expects the public key as a 128-character
+ * hex string (without the 04 prefix).
+ *
+ * @param privateKey - Private key in hex format
+ * @returns Public key ID (128 chars, no prefix)
+ *
+ * @example
+ * ```typescript
+ * const keyPair = generateKeyPair();
+ * const publicKeyId = getPublicKeyForRegistration(keyPair.privateKey);
+ *
+ * await fetch('https://bridge/agent/register', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     signingMode: 'self',
+ *     publicKey: publicKeyId,
+ *     displayName: 'My Agent',
+ *   }),
+ * });
+ * ```
+ */
+function getPublicKeyForRegistration(privateKey) {
+    return (0, wallet_js_1.getPublicKeyId)(privateKey);
+}
+exports.getPublicKeyForRegistration = getPublicKeyForRegistration;

package/dist/cjs/ottochain/metagraph-client.js

@@ -11,6 +11,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetagraphClient = void 0;
+const transaction_js_1 = require("../metakit/transaction.js");
 const client_js_1 = require("../metakit/network/client.js");
 const types_js_1 = require("../metakit/network/types.js");
 const snapshot_js_1 = require("./snapshot.js");
@@ -43,6 +44,9 @@ class MetagraphClient {
         if (config.dl1Url) {
             this.dl1 = new client_js_1.HttpClient(config.dl1Url, config.timeout);
         }
+        // Build DL1 client pool from dl1Urls (falls back to dl1Url if provided)
+        const urls = config.dl1Urls ?? (config.dl1Url ? [config.dl1Url] : []);
+        this.dl1Clients = urls.map((url) => new client_js_1.HttpClient(url, config.timeout));
     }
     // -------------------------------------------------------------------------
     // Custom routes (ML0 /data-application/v1/*)
@@ -300,5 +304,53 @@ class MetagraphClient {
         }
         return this.dl1.post('/data', signedData);
     }
+    /**
+     * Submit a self-signed transaction directly to DL1 nodes.
+     *
+     * Wraps the signed payload in `{ data, fee: null }` format and submits
+     * to one of the configured DL1 nodes. Uses `Promise.any` when multiple
+     * DL1 URLs are configured for resilience.
+     *
+     * @param signed - A `Signed<T>` object from `signTransaction()`
+     * @returns Response containing the data hash
+     * @throws Error if no DL1 URLs are configured or all nodes fail
+     *
+     * @example
+     * ```typescript
+     * const metagraph = new MetagraphClient({
+     *   ml0Url: 'http://localhost:9200',
+     *   dl1Urls: ['http://node1:9400', 'http://node2:9400'],
+     * });
+     * const signed = await signTransaction(payload, privateKey);
+     * await metagraph.submitData(signed);
+     * ```
+     */
+    async submitData(signed) {
+        if (this.dl1Clients.length === 0) {
+            throw new Error('dl1Url or dl1Urls is required for submitData');
+        }
+        const request = (0, transaction_js_1.createDataTransactionRequest)(signed);
+        if (this.dl1Clients.length === 1) {
+            return this.dl1Clients[0].post('/data', request);
+        }
+        // Try all DL1 nodes concurrently, return first success
+        const errors = [];
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let pending = this.dl1Clients.length;
+            for (const client of this.dl1Clients) {
+                client.post('/data', request).then((result) => { if (!settled) {
+                    settled = true;
+                    resolve(result);
+                } }, (err) => {
+                    errors.push(err instanceof Error ? err : new Error(String(err)));
+                    pending--;
+                    if (pending === 0 && !settled) {
+                        reject(new Error('All DL1 nodes failed: ' + errors.map(e => e.message).join('; ')));
+                    }
+                });
+            }
+        });
+    }
 }
 exports.MetagraphClient = MetagraphClient;