@ottochain/sdk 1.4.1 → 1.5.0

package/dist/esm/ottochain/transaction.js

@@ -1,13 +1,10 @@
-"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 metagraph_sdk_1 = require("@constellation-network/metagraph-sdk");
+import { signDataUpdate, getPublicKeyId } from '@constellation-network/metagraph-sdk';
 /**
  * Create a new state machine fiber payload.
  *
@@ -27,7 +24,7 @@ const metagraph_sdk_1 = require("@constellation-network/metagraph-sdk");
  * const signed = await signTransaction(create, privateKey);
  * ```
  */
-function createStateMachinePayload(params) {
+export function createStateMachinePayload(params) {
     return {
         CreateStateMachine: {
             fiberId: params.fiberId,
@@ -37,7 +34,6 @@ function createStateMachinePayload(params) {
         },
     };
 }
-exports.createStateMachinePayload = createStateMachinePayload;
 /**
  * Create a transition payload ready for signing.
  *
@@ -56,7 +52,7 @@ exports.createStateMachinePayload = createStateMachinePayload;
  * });
  * ```
  */
-function createTransitionPayload(params) {
+export function createTransitionPayload(params) {
     return {
         TransitionStateMachine: {
             fiberId: params.fiberId,
@@ -66,14 +62,13 @@ function createTransitionPayload(params) {
         },
     };
 }
-exports.createTransitionPayload = createTransitionPayload;
 /**
  * Create an archive payload ready for signing.
  *
  * @param params - Archive parameters
  * @returns An ArchiveStateMachine message ready for signing
  */
-function createArchivePayload(params) {
+export function createArchivePayload(params) {
     return {
         ArchiveStateMachine: {
             fiberId: params.fiberId,
@@ -81,7 +76,6 @@ function createArchivePayload(params) {
         },
     };
 }
-exports.createArchivePayload = createArchivePayload;
 /**
  * Create a new script fiber payload.
  *
@@ -105,7 +99,7 @@ exports.createArchivePayload = createArchivePayload;
  * const signed = await signTransaction(script, privateKey);
  * ```
  */
-function createScriptPayload(params) {
+export function createScriptPayload(params) {
     return {
         CreateScript: {
             fiberId: params.fiberId,
@@ -115,14 +109,13 @@ function createScriptPayload(params) {
         },
     };
 }
-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) {
+export function createInvokeScriptPayload(params) {
     return {
         InvokeScript: {
             fiberId: params.fiberId,
@@ -132,7 +125,6 @@ function createInvokeScriptPayload(params) {
         },
     };
 }
-exports.createInvokeScriptPayload = createInvokeScriptPayload;
 /**
  * Sign a transaction payload for self-signed mode.
  *
@@ -170,14 +162,13 @@ exports.createInvokeScriptPayload = createInvokeScriptPayload;
  * });
  * ```
  */
-async function signTransaction(message, privateKey) {
-    const proof = await (0, metagraph_sdk_1.signDataUpdate)(message, privateKey);
+export async function signTransaction(message, privateKey) {
+    const proof = await 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.
@@ -199,10 +190,9 @@ exports.signTransaction = signTransaction;
  * });
  * ```
  */
-function createDataTransactionRequest(signed) {
+export function createDataTransactionRequest(signed) {
     return { data: signed, fee: null };
 }
-exports.createDataTransactionRequest = createDataTransactionRequest;
 /**
  * Add an additional signature to a signed transaction.
  *
@@ -213,14 +203,13 @@ exports.createDataTransactionRequest = createDataTransactionRequest;
  * @param privateKey - Additional signer's private key
  * @returns Transaction with additional signature
  */
-async function addTransactionSignature(signed, privateKey) {
-    const newProof = await (0, metagraph_sdk_1.signDataUpdate)(signed.value, privateKey);
+export async function addTransactionSignature(signed, privateKey) {
+    const newProof = await 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.
  *
@@ -245,7 +234,6 @@ exports.addTransactionSignature = addTransactionSignature;
  * });
  * ```
  */
-function getPublicKeyForRegistration(privateKey) {
-    return (0, metagraph_sdk_1.getPublicKeyId)(privateKey);
+export function getPublicKeyForRegistration(privateKey) {
+    return getPublicKeyId(privateKey);
 }
-exports.getPublicKeyForRegistration = getPublicKeyForRegistration;

package/dist/esm/ottochain/types.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Ottochain-specific type definitions
  *
@@ -8,4 +7,4 @@
  * @see modules/models/src/main/scala/xyz/kd5ujc/schema/
  * @packageDocumentation
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/esm/types.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * OttoChain Type Aliases
  *
@@ -7,19 +6,15 @@
  *
  * @packageDocumentation
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidFiberId = exports.isValidAddress = void 0;
 /**
  * Validate a DAG address format.
  */
-function isValidAddress(value) {
+export function isValidAddress(value) {
     return /^DAG[0-9a-zA-Z]+$/.test(value);
 }
-exports.isValidAddress = isValidAddress;
 /**
  * Validate a UUID format.
  */
-function isValidFiberId(value) {
+export function isValidFiberId(value) {
     return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
 }
-exports.isValidFiberId = isValidFiberId;

package/dist/esm/validation.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Input Validation with Zod Schemas
  *
@@ -6,10 +5,8 @@
  *
  * @packageDocumentation
  */
-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 = void 0;
-const zod_1 = require("zod");
-const errors_js_1 = require("./errors.js");
+import { z } from 'zod';
+import { ValidationError } from './errors.js';
 // ============================================================================
 // Primitive Schemas
 // ============================================================================
@@ -17,7 +14,7 @@ const errors_js_1 = require("./errors.js");
  * Schema for a hex string of specific length
  */
 const hexString = (length) => {
-    let schema = zod_1.z.string().regex(/^[0-9a-fA-F]+$/, 'Must be a valid hex string');
+    let schema = z.string().regex(/^[0-9a-fA-F]+$/, 'Must be a valid hex string');
     if (length !== undefined) {
         schema = schema.length(length, `Must be exactly ${length} characters`);
     }
@@ -26,7 +23,7 @@ const hexString = (length) => {
 /**
  * Schema for a DAG address
  */
-exports.DagAddressSchema = zod_1.z
+export const DagAddressSchema = z
     .string()
     .regex(/^DAG[0-9][a-zA-Z0-9]{36}$/, 'Must be a valid DAG address');
 // ============================================================================
@@ -35,29 +32,29 @@ exports.DagAddressSchema = zod_1.z
 /**
  * Schema for a private key (64-character hex string)
  */
-exports.PrivateKeySchema = hexString(64).describe('Private key in hex format (64 characters)');
+export const PrivateKeySchema = hexString(64).describe('Private key in hex format (64 characters)');
 /**
  * Schema for a public key (128 or 130 character hex string)
  */
-exports.PublicKeySchema = zod_1.z
+export const PublicKeySchema = z
     .string()
     .regex(/^(04)?[0-9a-fA-F]{128}$/, 'Must be a valid public key (128 or 130 hex chars)')
     .describe('Public key in hex format (with optional 04 prefix)');
 /**
  * Schema for a KeyPair
  */
-exports.KeyPairSchema = zod_1.z.object({
+export const KeyPairSchema = z.object({
     /** Private key in hex format */
-    privateKey: exports.PrivateKeySchema,
+    privateKey: PrivateKeySchema,
     /** Public key in hex format (uncompressed, with 04 prefix) */
-    publicKey: exports.PublicKeySchema,
+    publicKey: PublicKeySchema,
     /** DAG address derived from the public key */
-    address: exports.DagAddressSchema,
+    address: DagAddressSchema,
 });
 /**
  * Schema for a SignatureProof
  */
-exports.SignatureProofSchema = zod_1.z.object({
+export const SignatureProofSchema = z.object({
     /** Public key hex (uncompressed, without 04 prefix) - 128 characters */
     id: hexString(128),
     /** DER-encoded ECDSA signature in hex format */
@@ -66,45 +63,44 @@ exports.SignatureProofSchema = zod_1.z.object({
 /**
  * Schema for a Signed object (generic)
  */
-const SignedSchema = (valueSchema) => zod_1.z.object({
+export const SignedSchema = (valueSchema) => z.object({
     value: valueSchema,
-    proofs: zod_1.z.array(exports.SignatureProofSchema).min(1, 'At least one proof is required'),
+    proofs: z.array(SignatureProofSchema).min(1, 'At least one proof is required'),
 });
-exports.SignedSchema = SignedSchema;
 // ============================================================================
 // Transaction Schemas
 // ============================================================================
 /**
  * Schema for TransactionReference
  */
-exports.TransactionReferenceSchema = zod_1.z.object({
-    ordinal: zod_1.z.number().int().min(0),
-    hash: zod_1.z.string().min(1),
+export const TransactionReferenceSchema = z.object({
+    ordinal: z.number().int().min(0),
+    hash: z.string().min(1),
 });
 /**
  * Schema for CurrencyTransactionValue
  */
-exports.CurrencyTransactionValueSchema = zod_1.z.object({
-    source: exports.DagAddressSchema,
-    destination: exports.DagAddressSchema,
-    amount: zod_1.z.number().int().positive('Amount must be positive'),
-    fee: zod_1.z.number().int().min(0).default(0),
+export const CurrencyTransactionValueSchema = z.object({
+    source: DagAddressSchema,
+    destination: DagAddressSchema,
+    amount: z.number().int().positive('Amount must be positive'),
+    fee: z.number().int().min(0).default(0),
 });
 /**
  * Schema for CurrencyTransaction
  */
-exports.CurrencyTransactionSchema = zod_1.z.object({
-    value: exports.CurrencyTransactionValueSchema,
-    parent: exports.TransactionReferenceSchema,
+export const CurrencyTransactionSchema = z.object({
+    value: CurrencyTransactionValueSchema,
+    parent: TransactionReferenceSchema,
 });
 /**
  * Schema for TransferParams
  */
-exports.TransferParamsSchema = zod_1.z.object({
-    from: exports.DagAddressSchema,
-    to: exports.DagAddressSchema,
-    amount: zod_1.z.number().positive('Amount must be positive'),
-    fee: zod_1.z.number().min(0).optional().default(0),
+export const TransferParamsSchema = z.object({
+    from: DagAddressSchema,
+    to: DagAddressSchema,
+    amount: z.number().positive('Amount must be positive'),
+    fee: z.number().min(0).optional().default(0),
 });
 // ============================================================================
 // Identity Schemas
@@ -112,22 +108,22 @@ exports.TransferParamsSchema = zod_1.z.object({
 /**
  * Schema for AgentIdentity registration
  */
-exports.AgentIdentityRegistrationSchema = zod_1.z.object({
+export const AgentIdentityRegistrationSchema = z.object({
     /** Public key in hex format */
-    publicKey: exports.PublicKeySchema,
+    publicKey: PublicKeySchema,
     /** Display name for the agent */
-    displayName: zod_1.z.string().min(1).max(64),
+    displayName: z.string().min(1).max(64),
     /** Initial reputation (default: 10) */
-    reputation: zod_1.z.number().int().min(0).optional().default(10),
+    reputation: z.number().int().min(0).optional().default(10),
 });
 /**
  * Schema for PlatformLink
  */
-exports.PlatformLinkSchema = zod_1.z.object({
-    platform: zod_1.z.enum(['DISCORD', 'TELEGRAM', 'TWITTER', 'GITHUB', 'CUSTOM']),
-    platformUserId: zod_1.z.string().min(1),
-    platformUsername: zod_1.z.string().min(1),
-    verified: zod_1.z.boolean().optional().default(false),
+export const PlatformLinkSchema = z.object({
+    platform: z.enum(['DISCORD', 'TELEGRAM', 'TWITTER', 'GITHUB', 'CUSTOM']),
+    platformUserId: z.string().min(1),
+    platformUsername: z.string().min(1),
+    verified: z.boolean().optional().default(false),
 });
 // ============================================================================
 // Contract Schemas
@@ -135,39 +131,39 @@ exports.PlatformLinkSchema = zod_1.z.object({
 /**
  * Schema for contract terms (flexible structure)
  */
-exports.ContractTermsSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+export const ContractTermsSchema = z.record(z.string(), z.unknown());
 /**
  * Schema for ProposeContractRequest
  */
-exports.ProposeContractRequestSchema = zod_1.z.object({
+export const ProposeContractRequestSchema = z.object({
     /** Proposer's DAG address */
-    proposer: exports.DagAddressSchema,
+    proposer: DagAddressSchema,
     /** Counterparty's DAG address */
-    counterparty: exports.DagAddressSchema,
+    counterparty: DagAddressSchema,
     /** Contract terms */
-    terms: exports.ContractTermsSchema,
+    terms: ContractTermsSchema,
     /** Human-readable description */
-    description: zod_1.z.string().min(1).max(1000),
+    description: z.string().min(1).max(1000),
 });
 /**
  * Schema for AcceptContractRequest
  */
-exports.AcceptContractRequestSchema = zod_1.z.object({
+export const AcceptContractRequestSchema = z.object({
     /** Contract ID to accept */
-    contractId: zod_1.z.string().min(1),
+    contractId: z.string().min(1),
     /** Acceptor's DAG address */
-    acceptor: exports.DagAddressSchema,
+    acceptor: DagAddressSchema,
 });
 /**
  * Schema for CompleteContractRequest
  */
-exports.CompleteContractRequestSchema = zod_1.z.object({
+export const CompleteContractRequestSchema = z.object({
     /** Contract ID to complete */
-    contractId: zod_1.z.string().min(1),
+    contractId: z.string().min(1),
     /** Completer's DAG address */
-    completer: exports.DagAddressSchema,
+    completer: DagAddressSchema,
     /** Proof of completion */
-    proof: zod_1.z.string().min(1),
+    proof: z.string().min(1),
 });
 // ============================================================================
 // Validation Helpers
@@ -187,7 +183,7 @@ exports.CompleteContractRequestSchema = zod_1.z.object({
  * // keyPair is now typed as ValidatedKeyPair
  * ```
  */
-function validate(schema, data, fieldName) {
+export function validate(schema, data, fieldName) {
     const result = schema.safeParse(data);
     if (!result.success) {
         const issues = result.error.issues;
@@ -195,7 +191,7 @@ function validate(schema, data, fieldName) {
         // Build a helpful error message
         const path = firstIssue.path.length > 0 ? firstIssue.path.join('.') : fieldName || 'input';
         const message = `Validation failed for '${path}': ${firstIssue.message}`;
-        throw new errors_js_1.ValidationError(message, {
+        throw new ValidationError(message, {
             field: path,
             value: data,
             details: {
@@ -209,7 +205,6 @@ function validate(schema, data, fieldName) {
     }
     return result.data;
 }
-exports.validate = validate;
 /**
  * Validate a private key
  *
@@ -217,10 +212,9 @@ exports.validate = validate;
  * @returns Validated private key
  * @throws {ValidationError} If validation fails
  */
-function validatePrivateKey(privateKey) {
-    return validate(exports.PrivateKeySchema, privateKey, 'privateKey');
+export function validatePrivateKey(privateKey) {
+    return validate(PrivateKeySchema, privateKey, 'privateKey');
 }
-exports.validatePrivateKey = validatePrivateKey;
 /**
  * Validate a public key
  *
@@ -228,10 +222,9 @@ exports.validatePrivateKey = validatePrivateKey;
  * @returns Validated public key
  * @throws {ValidationError} If validation fails
  */
-function validatePublicKey(publicKey) {
-    return validate(exports.PublicKeySchema, publicKey, 'publicKey');
+export function validatePublicKey(publicKey) {
+    return validate(PublicKeySchema, publicKey, 'publicKey');
 }
-exports.validatePublicKey = validatePublicKey;
 /**
  * Validate a DAG address
  *
@@ -239,10 +232,9 @@ exports.validatePublicKey = validatePublicKey;
  * @returns Validated address
  * @throws {ValidationError} If validation fails
  */
-function validateAddress(address) {
-    return validate(exports.DagAddressSchema, address, 'address');
+export function validateAddress(address) {
+    return validate(DagAddressSchema, address, 'address');
 }
-exports.validateAddress = validateAddress;
 /**
  * Validate a KeyPair
  *
@@ -250,10 +242,9 @@ exports.validateAddress = validateAddress;
  * @returns Validated KeyPair
  * @throws {ValidationError} If validation fails
  */
-function validateKeyPair(keyPair) {
-    return validate(exports.KeyPairSchema, keyPair, 'keyPair');
+export function validateKeyPair(keyPair) {
+    return validate(KeyPairSchema, keyPair, 'keyPair');
 }
-exports.validateKeyPair = validateKeyPair;
 /**
  * Safe validation that returns a result object instead of throwing
  *
@@ -271,7 +262,7 @@ exports.validateKeyPair = validateKeyPair;
  * }
  * ```
  */
-function safeParse(schema, data) {
+export function safeParse(schema, data) {
     const result = schema.safeParse(data);
     if (result.success) {
         return { success: true, data: result.data };
@@ -282,7 +273,7 @@ function safeParse(schema, data) {
     const message = `Validation failed for '${path}': ${firstIssue.message}`;
     return {
         success: false,
-        error: new errors_js_1.ValidationError(message, {
+        error: new ValidationError(message, {
             field: path,
             value: data,
             details: {
@@ -295,7 +286,6 @@ function safeParse(schema, data) {
         }),
     };
 }
-exports.safeParse = safeParse;
 /**
  * Assert that a condition is true, throwing ValidationError if not
  *
@@ -304,9 +294,8 @@ exports.safeParse = safeParse;
  * @param field - Optional field name for context
  * @throws {ValidationError} If condition is false
  */
-function assert(condition, message, field) {
+export function assert(condition, message, field) {
     if (!condition) {
-        throw new errors_js_1.ValidationError(message, { field });
+        throw new ValidationError(message, { field });
     }
 }
-exports.assert = assert;

package/dist/esm/verify.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Backward-compatible verify wrapper.
  *
@@ -6,12 +5,9 @@
  * its verify() ignores the `isDataUpdate` parameter when `mode` is present.
  * This wrapper strips `mode` so callers' explicit `isDataUpdate` always wins.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.verify = void 0;
-const metagraph_sdk_1 = require("@constellation-network/metagraph-sdk");
-function verify(signed, isDataUpdate) {
+import { verify as _verify } from '@constellation-network/metagraph-sdk';
+export function verify(signed, isDataUpdate) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const { mode, ...rest } = signed;
-    return (0, metagraph_sdk_1.verify)(rest, isDataUpdate);
+    return _verify(rest, isDataUpdate);
 }
-exports.verify = verify;

package/dist/types/ottochain/normalize.d.ts

@@ -20,13 +20,12 @@
 /**
  * Normalize a CreateStateMachine message for wire format
  *
- * Ensures all Option fields are explicit null:
- * - definition.metadata
- * - definition.states[*].metadata
- * - definition.transitions[*].guard
- * - definition.transitions[*].actions
- * - definition.transitions[*].metadata
- * - parentFiberId
+ * Ensures all Option/default fields are explicit in wire format:
+ * - definition.metadata → null when absent
+ * - definition.states[*].metadata → null when absent
+ * - definition.transitions[*].dependencies → [] when absent
+ * - parentFiberId → null when absent
+ * - participants → null when absent (Optional Set[Address] for multi-party signing)
  *
  * @example
  * ```typescript
@@ -35,7 +34,7 @@
  *   definition: { states: { INIT: { id: { value: 'INIT' }, isFinal: false } }, ... },
  *   initialData: {}
  * });
- * // message now has parentFiberId: null, definition.metadata: null, etc.
+ * // message now has parentFiberId: null, participants: null, definition.metadata: null, etc.
  * ```
  */
 export declare function normalizeCreateStateMachine(msg: Record<string, unknown>): Record<string, unknown>;

package/dist/types/ottochain/types.d.ts

@@ -157,7 +157,9 @@ export interface CreateStateMachine {
     fiberId: string;
     definition: StateMachineDefinition;
     initialData: JsonLogicValue;
-    parentFiberId?: string;
+    parentFiberId?: string | null;
+    /** Optional set of DAG addresses authorized to sign transitions (multi-party signing). */
+    participants?: string[] | null;
 }
 /**
  * Trigger a state machine transition.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ottochain/sdk",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "TypeScript SDK for ottochain metagraph operations - signing, encoding, and network interactions",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -100,18 +100,18 @@
   "devDependencies": {
     "@babel/preset-env": "^7.29.0",
     "@commitlint/cli": "^20.4.4",
-    "@commitlint/config-conventional": "^19.0.0",
-    "@eslint/js": "^9.39.3",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/js": "^9.39.4",
     "@jest/globals": "^30.3.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "eslint": "^9.39.3",
-    "jest": "^30.2.0",
+    "jest": "^30.3.0",
     "prettier": "^3.0.0",
     "ts-jest": "^29.0.0",
-    "ts-proto": "^2.11.2",
+    "ts-proto": "^2.11.5",
     "typedoc": "^0.28.17",
     "typescript": "^5.0.0"
   },