@ottochain/sdk 0.2.0

package/dist/cjs/generated/ottochain/v1/records_pb.js

@@ -0,0 +1,44 @@
+"use strict";
+// @generated by protoc-gen-es v2.2.0 with parameter "target=ts,import_extension=.js"
+// @generated from file ottochain/v1/records.proto (package ottochain.v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalculatedStateSchema = exports.FiberLogEntryListSchema = exports.OnChainStateSchema = exports.FiberCommitSchema = exports.ScriptFiberRecordSchema = exports.StateMachineFiberRecordSchema = exports.file_ottochain_v1_records = void 0;
+const codegenv1_1 = require("@bufbuild/protobuf/codegenv1");
+const common_pb_js_1 = require("./common_pb.js");
+const fiber_pb_js_1 = require("./fiber_pb.js");
+const wkt_1 = require("@bufbuild/protobuf/wkt");
+/**
+ * Describes the file ottochain/v1/records.proto.
+ */
+exports.file_ottochain_v1_records = (0, codegenv1_1.fileDesc)("ChpvdHRvY2hhaW4vdjEvcmVjb3Jkcy5wcm90bxIMb3R0b2NoYWluLnYxIsIFChdTdGF0ZU1hY2hpbmVGaWJlclJlY29yZBIQCghmaWJlcl9pZBgBIAEoCRI3ChBjcmVhdGlvbl9vcmRpbmFsGAIgASgLMh0ub3R0b2NoYWluLnYxLlNuYXBzaG90T3JkaW5hbBI+ChdwcmV2aW91c191cGRhdGVfb3JkaW5hbBgDIAEoCzIdLm90dG9jaGFpbi52MS5TbmFwc2hvdE9yZGluYWwSPAoVbGF0ZXN0X3VwZGF0ZV9vcmRpbmFsGAQgASgLMh0ub3R0b2NoYWluLnYxLlNuYXBzaG90T3JkaW5hbBI4CgpkZWZpbml0aW9uGAUgASgLMiQub3R0b2NoYWluLnYxLlN0YXRlTWFjaGluZURlZmluaXRpb24SLAoNY3VycmVudF9zdGF0ZRgGIAEoCzIVLm90dG9jaGFpbi52MS5TdGF0ZUlkEioKCnN0YXRlX2RhdGEYByABKAsyFi5nb29nbGUucHJvdG9idWYuVmFsdWUSMAoPc3RhdGVfZGF0YV9oYXNoGAggASgLMhcub3R0b2NoYWluLnYxLkhhc2hWYWx1ZRIzCg9zZXF1ZW5jZV9udW1iZXIYCSABKAsyGi5vdHRvY2hhaW4udjEuRmliZXJPcmRpbmFsEiUKBm93bmVycxgKIAMoCzIVLm90dG9jaGFpbi52MS5BZGRyZXNzEikKBnN0YXR1cxgLIAEoDjIZLm90dG9jaGFpbi52MS5GaWJlclN0YXR1cxI1CgxsYXN0X3JlY2VpcHQYDCABKAsyGi5vdHRvY2hhaW4udjEuRXZlbnRSZWNlaXB0SACIAQESHAoPcGFyZW50X2ZpYmVyX2lkGA0gASgJSAGIAQESFwoPY2hpbGRfZmliZXJfaWRzGA4gAygJQg8KDV9sYXN0X3JlY2VpcHRCEgoQX3BhcmVudF9maWJlcl9pZCLrBAoRU2NyaXB0RmliZXJSZWNvcmQSEAoIZmliZXJfaWQYASABKAkSNwoQY3JlYXRpb25fb3JkaW5hbBgCIAEoCzIdLm90dG9jaGFpbi52MS5TbmFwc2hvdE9yZGluYWwSPAoVbGF0ZXN0X3VwZGF0ZV9vcmRpbmFsGAMgASgLMh0ub3R0b2NoYWluLnYxLlNuYXBzaG90T3JkaW5hbBIuCg5zY3JpcHRfcHJvZ3JhbRgEIAEoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRIvCgpzdGF0ZV9kYXRhGAUgASgLMhYuZ29vZ2xlLnByb3RvYnVmLlZhbHVlSACIAQESNQoPc3RhdGVfZGF0YV9oYXNoGAYgASgLMhcub3R0b2NoYWluLnYxLkhhc2hWYWx1ZUgBiAEBEjkKDmFjY2Vzc19jb250cm9sGAcgASgLMiEub3R0b2NoYWluLnYxLkFjY2Vzc0NvbnRyb2xQb2xpY3kSMwoPc2VxdWVuY2VfbnVtYmVyGAggASgLMhoub3R0b2NoYWluLnYxLkZpYmVyT3JkaW5hbBIlCgZvd25lcnMYCSADKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxIpCgZzdGF0dXMYCiABKA4yGS5vdHRvY2hhaW4udjEuRmliZXJTdGF0dXMSPAoPbGFzdF9pbnZvY2F0aW9uGAsgASgLMh4ub3R0b2NoYWluLnYxLlNjcmlwdEludm9jYXRpb25IAogBAUINCgtfc3RhdGVfZGF0YUISChBfc3RhdGVfZGF0YV9oYXNoQhIKEF9sYXN0X2ludm9jYXRpb24iuwEKC0ZpYmVyQ29tbWl0EiwKC3JlY29yZF9oYXNoGAEgASgLMhcub3R0b2NoYWluLnYxLkhhc2hWYWx1ZRI1Cg9zdGF0ZV9kYXRhX2hhc2gYAiABKAsyFy5vdHRvY2hhaW4udjEuSGFzaFZhbHVlSACIAQESMwoPc2VxdWVuY2VfbnVtYmVyGAMgASgLMhoub3R0b2NoYWluLnYxLkZpYmVyT3JkaW5hbEISChBfc3RhdGVfZGF0YV9oYXNoIrgCCgxPbkNoYWluU3RhdGUSQwoNZmliZXJfY29tbWl0cxgBIAMoCzIsLm90dG9jaGFpbi52MS5PbkNoYWluU3RhdGUuRmliZXJDb21taXRzRW50cnkSPwoLbGF0ZXN0X2xvZ3MYAiADKAsyKi5vdHRvY2hhaW4udjEuT25DaGFpblN0YXRlLkxhdGVzdExvZ3NFbnRyeRpOChFGaWJlckNvbW1pdHNFbnRyeRILCgNrZXkYASABKAkSKAoFdmFsdWUYAiABKAsyGS5vdHRvY2hhaW4udjEuRmliZXJDb21taXQ6AjgBGlIKD0xhdGVzdExvZ3NFbnRyeRILCgNrZXkYASABKAkSLgoFdmFsdWUYAiABKAsyHy5vdHRvY2hhaW4udjEuRmliZXJMb2dFbnRyeUxpc3Q6AjgBIkEKEUZpYmVyTG9nRW50cnlMaXN0EiwKB2VudHJpZXMYASADKAsyGy5vdHRvY2hhaW4udjEuRmliZXJMb2dFbnRyeSLGAgoPQ2FsY3VsYXRlZFN0YXRlEkgKDnN0YXRlX21hY2hpbmVzGAEgAygLMjAub3R0b2NoYWluLnYxLkNhbGN1bGF0ZWRTdGF0ZS5TdGF0ZU1hY2hpbmVzRW50cnkSOwoHc2NyaXB0cxgCIAMoCzIqLm90dG9jaGFpbi52MS5DYWxjdWxhdGVkU3RhdGUuU2NyaXB0c0VudHJ5GlsKElN0YXRlTWFjaGluZXNFbnRyeRILCgNrZXkYASABKAkSNAoFdmFsdWUYAiABKAsyJS5vdHRvY2hhaW4udjEuU3RhdGVNYWNoaW5lRmliZXJSZWNvcmQ6AjgBGk8KDFNjcmlwdHNFbnRyeRILCgNrZXkYASABKAkSLgoFdmFsdWUYAiABKAsyHy5vdHRvY2hhaW4udjEuU2NyaXB0RmliZXJSZWNvcmQ6AjgBQnEKEGNvbS5vdHRvY2hhaW4udjFCDFJlY29yZHNQcm90b1ABogIDT1hYqgIMT3R0b2NoYWluLlYxygIMT3R0b2NoYWluXFYx4gIYT3R0b2NoYWluXFYxXEdQQk1ldGFkYXRh6gINT3R0b2NoYWluOjpWMWIGcHJvdG8z", [common_pb_js_1.file_ottochain_v1_common, fiber_pb_js_1.file_ottochain_v1_fiber, wkt_1.file_google_protobuf_struct]);
+/**
+ * Describes the message ottochain.v1.StateMachineFiberRecord.
+ * Use `create(StateMachineFiberRecordSchema)` to create a new message.
+ */
+exports.StateMachineFiberRecordSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 0);
+/**
+ * Describes the message ottochain.v1.ScriptFiberRecord.
+ * Use `create(ScriptFiberRecordSchema)` to create a new message.
+ */
+exports.ScriptFiberRecordSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 1);
+/**
+ * Describes the message ottochain.v1.FiberCommit.
+ * Use `create(FiberCommitSchema)` to create a new message.
+ */
+exports.FiberCommitSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 2);
+/**
+ * Describes the message ottochain.v1.OnChainState.
+ * Use `create(OnChainStateSchema)` to create a new message.
+ */
+exports.OnChainStateSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 3);
+/**
+ * Describes the message ottochain.v1.FiberLogEntryList.
+ * Use `create(FiberLogEntryListSchema)` to create a new message.
+ */
+exports.FiberLogEntryListSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 4);
+/**
+ * Describes the message ottochain.v1.CalculatedState.
+ * Use `create(CalculatedStateSchema)` to create a new message.
+ */
+exports.CalculatedStateSchema = (0, codegenv1_1.messageDesc)(exports.file_ottochain_v1_records, 5);

package/dist/cjs/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Ottochain SDK
+ *
+ * Unified SDK combining metakit framework operations with ottochain domain types.
+ *
+ * Structure:
+ * - `metakit` — Signing, encoding, hashing, and network clients for Constellation metagraphs
+ * - `generated` — Protobuf-generated types (source of truth)
+ * - `apps/identity` — Agent Identity application types
+ * - `apps/contracts` — Contract application types
+ * - `errors` — Custom error classes for structured error handling
+ * - `validation` — Input validation with Zod schemas
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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;
+// Type aliases for semantic clarity (matches wire format)
+__exportStar(require("./types.js"), exports);
+// Metakit utilities (signing, hashing, HTTP client)
+__exportStar(require("./metakit/index.js"), exports);
+// Generated protobuf types (canonical definitions)
+__exportStar(require("./generated/index.js"), exports);
+// Custom error classes
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "OttoChainError", { enumerable: true, get: function () { return errors_js_1.OttoChainError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_js_1.NetworkError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
+Object.defineProperty(exports, "SigningError", { enumerable: true, get: function () { return errors_js_1.SigningError; } });
+Object.defineProperty(exports, "TransactionError", { enumerable: true, get: function () { return errors_js_1.TransactionError; } });
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_js_1.ErrorCode; } });
+Object.defineProperty(exports, "isErrorCode", { enumerable: true, get: function () { return errors_js_1.isErrorCode; } });
+Object.defineProperty(exports, "wrapError", { enumerable: true, get: function () { return errors_js_1.wrapError; } });
+// Validation schemas and helpers
+var validation_js_1 = require("./validation.js");
+// Schemas
+Object.defineProperty(exports, "DagAddressSchema", { enumerable: true, get: function () { return validation_js_1.DagAddressSchema; } });
+Object.defineProperty(exports, "PrivateKeySchema", { enumerable: true, get: function () { return validation_js_1.PrivateKeySchema; } });
+Object.defineProperty(exports, "PublicKeySchema", { enumerable: true, get: function () { return validation_js_1.PublicKeySchema; } });
+Object.defineProperty(exports, "KeyPairSchema", { enumerable: true, get: function () { return validation_js_1.KeyPairSchema; } });
+Object.defineProperty(exports, "SignatureProofSchema", { enumerable: true, get: function () { return validation_js_1.SignatureProofSchema; } });
+Object.defineProperty(exports, "SignedSchema", { enumerable: true, get: function () { return validation_js_1.SignedSchema; } });
+Object.defineProperty(exports, "TransactionReferenceSchema", { enumerable: true, get: function () { return validation_js_1.TransactionReferenceSchema; } });
+Object.defineProperty(exports, "CurrencyTransactionValueSchema", { enumerable: true, get: function () { return validation_js_1.CurrencyTransactionValueSchema; } });
+Object.defineProperty(exports, "CurrencyTransactionSchema", { enumerable: true, get: function () { return validation_js_1.CurrencyTransactionSchema; } });
+Object.defineProperty(exports, "TransferParamsSchema", { enumerable: true, get: function () { return validation_js_1.TransferParamsSchema; } });
+Object.defineProperty(exports, "AgentIdentityRegistrationSchema", { enumerable: true, get: function () { return validation_js_1.AgentIdentityRegistrationSchema; } });
+Object.defineProperty(exports, "PlatformLinkSchema", { enumerable: true, get: function () { return validation_js_1.PlatformLinkSchema; } });
+Object.defineProperty(exports, "ContractTermsSchema", { enumerable: true, get: function () { return validation_js_1.ContractTermsSchema; } });
+Object.defineProperty(exports, "ProposeContractRequestSchema", { enumerable: true, get: function () { return validation_js_1.ProposeContractRequestSchema; } });
+Object.defineProperty(exports, "AcceptContractRequestSchema", { enumerable: true, get: function () { return validation_js_1.AcceptContractRequestSchema; } });
+Object.defineProperty(exports, "CompleteContractRequestSchema", { enumerable: true, get: function () { return validation_js_1.CompleteContractRequestSchema; } });
+// Helpers
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return validation_js_1.validate; } });
+Object.defineProperty(exports, "validatePrivateKey", { enumerable: true, get: function () { return validation_js_1.validatePrivateKey; } });
+Object.defineProperty(exports, "validatePublicKey", { enumerable: true, get: function () { return validation_js_1.validatePublicKey; } });
+Object.defineProperty(exports, "validateAddress", { enumerable: true, get: function () { return validation_js_1.validateAddress; } });
+Object.defineProperty(exports, "validateKeyPair", { enumerable: true, get: function () { return validation_js_1.validateKeyPair; } });
+Object.defineProperty(exports, "safeParse", { enumerable: true, get: function () { return validation_js_1.safeParse; } });
+Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return validation_js_1.assert; } });
+// Error classes
+__exportStar(require("./errors.js"), exports);
+// Validation schemas and helpers
+__exportStar(require("./validation.js"), exports);

package/dist/cjs/metakit/binary.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Binary Encoding
+ *
+ * Converts JSON data to binary format for cryptographic operations.
+ * Supports both regular encoding and DataUpdate encoding with Constellation prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeDataUpdate = exports.toBytes = void 0;
+const canonicalize_js_1 = require("./canonicalize.js");
+const types_js_1 = require("./types.js");
+/**
+ * Convert data to binary bytes for signing
+ *
+ * For regular data:
+ *   JSON -> RFC 8785 canonicalization -> UTF-8 bytes
+ *
+ * For DataUpdate (isDataUpdate=true):
+ *   JSON -> RFC 8785 -> UTF-8 -> Base64 -> prepend Constellation prefix -> UTF-8 bytes
+ *
+ * @param data - Any JSON-serializable object
+ * @param isDataUpdate - If true, applies DataUpdate encoding with Constellation prefix
+ * @returns Binary bytes as Uint8Array
+ *
+ * @example
+ * ```typescript
+ * // Regular encoding
+ * const bytes = toBytes({ action: 'test' });
+ *
+ * // DataUpdate encoding
+ * const updateBytes = toBytes({ action: 'test' }, true);
+ * ```
+ */
+function toBytes(data, isDataUpdate = false) {
+    const canonicalJson = (0, canonicalize_js_1.canonicalize)(data);
+    const utf8Bytes = new TextEncoder().encode(canonicalJson);
+    if (isDataUpdate) {
+        // Base64 encode the UTF-8 bytes
+        const base64String = Buffer.from(utf8Bytes).toString('base64');
+        // Create the wrapped string with Constellation prefix
+        const wrappedString = `${types_js_1.CONSTELLATION_PREFIX}${base64String.length}\n${base64String}`;
+        return new TextEncoder().encode(wrappedString);
+    }
+    return utf8Bytes;
+}
+exports.toBytes = toBytes;
+/**
+ * Encode data as a DataUpdate with Constellation prefix
+ *
+ * This is equivalent to `toBytes(data, true)`.
+ *
+ * @param data - Any JSON-serializable object
+ * @returns Binary bytes with Constellation prefix
+ */
+function encodeDataUpdate(data) {
+    return toBytes(data, true);
+}
+exports.encodeDataUpdate = encodeDataUpdate;

package/dist/cjs/metakit/canonicalize.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * RFC 8785 JSON Canonicalization
+ *
+ * Provides deterministic JSON serialization according to RFC 8785.
+ * This ensures identical JSON objects always produce identical strings.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalize = void 0;
+const canonicalize_1 = __importDefault(require("canonicalize"));
+/**
+ * Canonicalize JSON data according to RFC 8785
+ *
+ * Key features:
+ * - Object keys sorted by UTF-16BE binary comparison
+ * - Numbers serialized in shortest decimal representation
+ * - No whitespace
+ * - Proper Unicode escaping
+ *
+ * @param data - Any JSON-serializable object
+ * @returns Canonical JSON string
+ * @throws Error if data cannot be serialized to JSON
+ *
+ * @example
+ * ```typescript
+ * const canonical = canonicalize({ b: 2, a: 1 });
+ * // Returns: '{"a":1,"b":2}'
+ * ```
+ */
+function canonicalize(data) {
+    const result = (0, canonicalize_1.default)(data);
+    if (result === undefined) {
+        throw new Error('Failed to canonicalize data: data cannot be serialized to JSON');
+    }
+    return result;
+}
+exports.canonicalize = canonicalize;

package/dist/cjs/metakit/codec.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Codec Utilities
+ *
+ * Encoding/decoding utilities for the Constellation signature protocol.
+ * Re-exports from binary.ts for backwards compatibility and provides additional utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeDataUpdate = exports.CONSTELLATION_PREFIX = exports.encodeDataUpdate = exports.toBytes = void 0;
+var binary_js_1 = require("./binary.js");
+Object.defineProperty(exports, "toBytes", { enumerable: true, get: function () { return binary_js_1.toBytes; } });
+Object.defineProperty(exports, "encodeDataUpdate", { enumerable: true, get: function () { return binary_js_1.encodeDataUpdate; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "CONSTELLATION_PREFIX", { enumerable: true, get: function () { return types_js_1.CONSTELLATION_PREFIX; } });
+/**
+ * Decode a DataUpdate encoded message back to its original JSON
+ *
+ * @param bytes - DataUpdate encoded bytes
+ * @returns Decoded JSON object
+ * @throws Error if bytes are not valid DataUpdate encoding
+ */
+function decodeDataUpdate(bytes) {
+    const text = new TextDecoder().decode(bytes);
+    // Validate prefix
+    if (!text.startsWith('\x19Constellation Signed Data:\n')) {
+        throw new Error('Invalid DataUpdate encoding: missing Constellation prefix');
+    }
+    // Parse the format: \x19Constellation Signed Data:\n{length}\n{base64}
+    const withoutPrefix = text.slice('\x19Constellation Signed Data:\n'.length);
+    const newlineIndex = withoutPrefix.indexOf('\n');
+    if (newlineIndex === -1) {
+        throw new Error('Invalid DataUpdate encoding: missing length delimiter');
+    }
+    const lengthStr = withoutPrefix.slice(0, newlineIndex);
+    const base64Data = withoutPrefix.slice(newlineIndex + 1);
+    const expectedLength = parseInt(lengthStr, 10);
+    if (isNaN(expectedLength) || base64Data.length !== expectedLength) {
+        throw new Error('Invalid DataUpdate encoding: length mismatch');
+    }
+    // Decode base64 to UTF-8 JSON
+    const jsonBytes = Buffer.from(base64Data, 'base64');
+    const jsonString = new TextDecoder().decode(jsonBytes);
+    return JSON.parse(jsonString);
+}
+exports.decodeDataUpdate = decodeDataUpdate;

package/dist/cjs/metakit/currency-transaction.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Currency transaction operations for metagraph token transfers
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransactionReference = exports.hashCurrencyTransaction = exports.encodeCurrencyTransaction = exports.verifyCurrencyTransaction = exports.signCurrencyTransaction = exports.createCurrencyTransactionBatch = exports.createCurrencyTransaction = exports.isValidDagAddress = exports.unitsToToken = exports.tokenToUnits = void 0;
+const dag4_keystore_1 = require("@stardust-collective/dag4-keystore");
+const currency_types_js_1 = require("./currency-types.js");
+const wallet_js_1 = require("./wallet.js");
+const verify_js_1 = require("./verify.js");
+/**
+ * Convert token amount to smallest units
+ *
+ * @param amount - Amount in token units (e.g., 100.5)
+ * @returns Amount in smallest units (1e-8)
+ *
+ * @example
+ * ```typescript
+ * const units = tokenToUnits(100.5); // 10050000000
+ * ```
+ */
+function tokenToUnits(amount) {
+    return Math.floor(amount * 1e8);
+}
+exports.tokenToUnits = tokenToUnits;
+/**
+ * Convert smallest units to token amount
+ *
+ * @param units - Amount in smallest units
+ * @returns Amount in token units
+ *
+ * @example
+ * ```typescript
+ * const tokens = unitsToToken(10050000000); // 100.5
+ * ```
+ */
+function unitsToToken(units) {
+    return units * currency_types_js_1.TOKEN_DECIMALS;
+}
+exports.unitsToToken = unitsToToken;
+/**
+ * Validate DAG address format
+ *
+ * @param address - DAG address to validate
+ * @returns True if address is valid
+ *
+ * @example
+ * ```typescript
+ * const valid = isValidDagAddress('DAG...');
+ * ```
+ */
+function isValidDagAddress(address) {
+    return dag4_keystore_1.keyStore.validateDagAddress(address);
+}
+exports.isValidDagAddress = isValidDagAddress;
+/**
+ * Create a metagraph token transaction
+ *
+ * @param params - Transfer parameters
+ * @param privateKey - Private key to sign with (hex string)
+ * @param lastRef - Reference to last accepted transaction
+ * @returns Signed currency transaction
+ *
+ * @throws If addresses are invalid or amount is too small
+ *
+ * @example
+ * ```typescript
+ * const tx = await createCurrencyTransaction(
+ *   { destination: 'DAG...', amount: 100.5, fee: 0 },
+ *   privateKey,
+ *   { hash: 'abc123...', ordinal: 5 }
+ * );
+ * ```
+ */
+async function createCurrencyTransaction(params, privateKey, lastRef) {
+    // Get source address from private key
+    const publicKey = dag4_keystore_1.keyStore.getPublicKeyFromPrivate(privateKey);
+    const source = (0, wallet_js_1.getAddress)(publicKey);
+    // Validate addresses
+    if (!isValidDagAddress(source)) {
+        throw new Error('Invalid source address');
+    }
+    if (!isValidDagAddress(params.destination)) {
+        throw new Error('Invalid destination address');
+    }
+    if (source === params.destination) {
+        throw new Error('Source and destination addresses cannot be the same');
+    }
+    // Convert amounts to smallest units
+    const amount = tokenToUnits(params.amount);
+    const fee = tokenToUnits(params.fee ?? 0);
+    // Validate amounts
+    if (amount < 1) {
+        throw new Error('Transfer amount must be greater than 1e-8');
+    }
+    if (fee < 0) {
+        throw new Error('Fee must be greater than or equal to zero');
+    }
+    // Use dag4.js TransactionV2 to create and encode the transaction
+    const txProps = {
+        fromAddress: source,
+        toAddress: params.destination,
+        amount,
+        fee,
+        lastTxRef: lastRef,
+    };
+    const tx = new dag4_keystore_1.TransactionV2(txProps);
+    // Get encoded transaction for hashing
+    const encodedTx = tx.getEncoded();
+    // Kryo serialize - v2 uses setReferences = false (matching dag4.js behavior)
+    const serializedTx = dag4_keystore_1.txEncode.kryoSerialize(encodedTx, false);
+    // Hash the serialized transaction
+    const hash = dag4_keystore_1.keyStore.sha256(Buffer.from(serializedTx, 'hex'));
+    // Sign the hash
+    const signature = await dag4_keystore_1.keyStore.sign(privateKey, hash);
+    // Get uncompressed public key
+    const uncompressedPublicKey = publicKey.length === 128 ? '04' + publicKey : publicKey;
+    // Verify signature
+    const success = dag4_keystore_1.keyStore.verify(uncompressedPublicKey, hash, signature);
+    if (!success) {
+        throw new Error('Sign-Verify failed');
+    }
+    // Add signature proof (remove '04' prefix from public key)
+    const proof = {
+        id: uncompressedPublicKey.substring(2),
+        signature,
+    };
+    tx.addSignature(proof);
+    return tx.getPostTransaction();
+}
+exports.createCurrencyTransaction = createCurrencyTransaction;
+/**
+ * Create multiple metagraph token transactions (batch)
+ *
+ * @param transfers - Array of transfer parameters
+ * @param privateKey - Private key to sign with
+ * @param lastRef - Reference to last accepted transaction
+ * @returns Array of signed currency transactions
+ *
+ * @throws If any address is invalid or amount is too small
+ *
+ * @example
+ * ```typescript
+ * const txns = await createCurrencyTransactionBatch(
+ *   [
+ *     { destination: 'DAG...1', amount: 10 },
+ *     { destination: 'DAG...2', amount: 20 },
+ *   ],
+ *   privateKey,
+ *   { hash: 'abc123...', ordinal: 5 }
+ * );
+ * ```
+ */
+async function createCurrencyTransactionBatch(transfers, privateKey, lastRef) {
+    const transactions = [];
+    let currentRef = { ...lastRef };
+    for (const transfer of transfers) {
+        const tx = await createCurrencyTransaction(transfer, privateKey, currentRef);
+        // Calculate hash for next transaction's parent reference
+        const hash = await hashCurrencyTransaction(tx);
+        // Update reference for next transaction
+        currentRef = {
+            hash: hash.value,
+            ordinal: currentRef.ordinal + 1,
+        };
+        transactions.push(tx);
+    }
+    return transactions;
+}
+exports.createCurrencyTransactionBatch = createCurrencyTransactionBatch;
+/**
+ * Add a signature to an existing currency transaction (for multi-sig)
+ *
+ * @param transaction - Transaction to sign
+ * @param privateKey - Private key to sign with
+ * @returns Transaction with additional signature
+ *
+ * @throws If sign-verify fails
+ *
+ * @example
+ * ```typescript
+ * const signedTx = await signCurrencyTransaction(tx, privateKey2);
+ * ```
+ */
+async function signCurrencyTransaction(transaction, privateKey) {
+    // Reconstruct TransactionV2 from PostTransaction
+    const tx = dag4_keystore_1.TransactionV2.fromPostTransaction(transaction);
+    // Restore existing proofs (fromPostTransaction doesn't copy them)
+    for (const existingProof of transaction.proofs) {
+        tx.addSignature(existingProof);
+    }
+    // Get encoded transaction
+    const encodedTx = tx.getEncoded();
+    // Kryo serialize - v2 uses setReferences = false (matching dag4.js behavior)
+    const serializedTx = dag4_keystore_1.txEncode.kryoSerialize(encodedTx, false);
+    const hash = dag4_keystore_1.keyStore.sha256(Buffer.from(serializedTx, 'hex'));
+    // Sign the hash
+    const publicKey = dag4_keystore_1.keyStore.getPublicKeyFromPrivate(privateKey);
+    const signature = await dag4_keystore_1.keyStore.sign(privateKey, hash);
+    // Verify signature
+    const uncompressedPublicKey = publicKey.length === 128 ? '04' + publicKey : publicKey;
+    const success = dag4_keystore_1.keyStore.verify(uncompressedPublicKey, hash, signature);
+    if (!success) {
+        throw new Error('Sign-Verify failed');
+    }
+    // Add new proof
+    const proof = {
+        id: uncompressedPublicKey.substring(2),
+        signature,
+    };
+    tx.addSignature(proof);
+    return tx.getPostTransaction();
+}
+exports.signCurrencyTransaction = signCurrencyTransaction;
+/**
+ * Verify all signatures on a currency transaction
+ *
+ * @param transaction - Transaction to verify
+ * @returns Verification result with valid/invalid proofs
+ *
+ * @example
+ * ```typescript
+ * const result = await verifyCurrencyTransaction(tx);
+ * console.log('Valid:', result.isValid);
+ * ```
+ */
+async function verifyCurrencyTransaction(transaction) {
+    // Reconstruct TransactionV2 to get encoded form
+    const tx = dag4_keystore_1.TransactionV2.fromPostTransaction(transaction);
+    // Get hash
+    const encodedTx = tx.getEncoded();
+    // Kryo serialize - v2 uses setReferences = false (matching dag4.js behavior)
+    const serializedTx = dag4_keystore_1.txEncode.kryoSerialize(encodedTx, false);
+    const hash = dag4_keystore_1.keyStore.sha256(Buffer.from(serializedTx, 'hex'));
+    const validProofs = [];
+    const invalidProofs = [];
+    // Verify each proof
+    for (const proof of transaction.proofs) {
+        const publicKey = '04' + proof.id; // Add back the '04' prefix
+        // Normalize signature to low-S form for BIP 62/146 compatibility
+        const normalizedSignature = (0, verify_js_1.normalizeSignatureToLowS)(proof.signature);
+        const isValid = dag4_keystore_1.keyStore.verify(publicKey, hash, normalizedSignature);
+        if (isValid) {
+            validProofs.push(proof);
+        }
+        else {
+            invalidProofs.push(proof);
+        }
+    }
+    return {
+        isValid: invalidProofs.length === 0 && validProofs.length > 0,
+        validProofs,
+        invalidProofs,
+    };
+}
+exports.verifyCurrencyTransaction = verifyCurrencyTransaction;
+/**
+ * Encode a currency transaction for hashing
+ *
+ * @param transaction - Transaction to encode
+ * @returns Hex-encoded string
+ *
+ * @example
+ * ```typescript
+ * const encoded = encodeCurrencyTransaction(tx);
+ * ```
+ */
+function encodeCurrencyTransaction(transaction) {
+    const tx = dag4_keystore_1.TransactionV2.fromPostTransaction(transaction);
+    return tx.getEncoded();
+}
+exports.encodeCurrencyTransaction = encodeCurrencyTransaction;
+/**
+ * Hash a currency transaction
+ *
+ * @param transaction - Transaction to hash
+ * @returns Hash object with value and bytes
+ *
+ * @example
+ * ```typescript
+ * const hash = await hashCurrencyTransaction(tx);
+ * console.log('Hash:', hash.value);
+ * ```
+ */
+async function hashCurrencyTransaction(transaction) {
+    const encoded = encodeCurrencyTransaction(transaction);
+    // Kryo serialize - v2 uses setReferences = false (matching dag4.js behavior)
+    const serialized = dag4_keystore_1.txEncode.kryoSerialize(encoded, false);
+    const hash = dag4_keystore_1.keyStore.sha256(Buffer.from(serialized, 'hex'));
+    return {
+        value: hash,
+        bytes: Buffer.from(hash, 'hex'),
+    };
+}
+exports.hashCurrencyTransaction = hashCurrencyTransaction;
+/**
+ * Get transaction reference from a currency transaction
+ * Useful for chaining transactions
+ *
+ * @param transaction - Transaction to extract reference from
+ * @param ordinal - Ordinal number for this transaction
+ * @returns Transaction reference
+ *
+ * @example
+ * ```typescript
+ * const ref = await getTransactionReference(tx, 6);
+ * // Use ref as lastRef for next transaction
+ * ```
+ */
+async function getTransactionReference(transaction, ordinal) {
+    const hash = await hashCurrencyTransaction(transaction);
+    return {
+        hash: hash.value,
+        ordinal,
+    };
+}
+exports.getTransactionReference = getTransactionReference;

package/dist/cjs/metakit/currency-types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Currency transaction types for metagraph token transfers
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_DECIMALS = void 0;
+/**
+ * Token decimals constant (1e-8)
+ * Same as DAG_DECIMALS from dag4.js
+ */
+exports.TOKEN_DECIMALS = 1e-8;