@kynesyslabs/demosdk 2.12.2 → 3.1.0

package/build/bridge/nativeBridgeTypes.d.ts

@@ -8,6 +8,7 @@ export type BridgeOperation = {
     destinationChain: SupportedEVMChain | SupportedNonEVMChain;
     originAddress: string;
     destinationAddress: string;
+    /** Stablecoin amount on the source foreign chain (NOT DEM/OS). */
     amount: string;
     token: SupportedStablecoin;
     txHash: string;
@@ -17,12 +18,12 @@ export type EVMTankData = {
     type: "evm";
     abi: string[];
     address: string;
-    amountExpected: number;
+    amountExpected: number | string;
 };
 export type SolanaTankData = {
     type: "solana";
     address: string;
-    amountExpected: number;
+    amountExpected: number | string;
 };
 export type CompiledContent = {
     operation: BridgeOperation;
@@ -45,7 +46,7 @@ export type NativeBridgeTxPayload = {
 export type BridgeOperationCompiledLegacy = {
     content: {
         operation: BridgeOperation;
-        amountExpected: number;
+        amountExpected: number | string;
         validUntil: number;
     } & ({
         originChain: "EVM";

package/build/bridge/nativeBridgeTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeBridgeTypes.js","sourceRoot":"","sources":["../../../src/bridge/nativeBridgeTypes.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAU,CAAA;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,CAAU,CAAA;AA8ErD,2BAA2B;AAC3B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,KAAK;IACL,SAAS;IACT,KAAK;IACL,UAAU;IACV,UAAU;IACV,WAAW;IACX,MAAM;CACA,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,CAAU,CAAA;AAExD,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,QAAQ,EAAE,4CAA4C,EAAE,eAAe;IACvE,OAAO,EAAE,4CAA4C,EAAE,cAAc;IACrE,GAAG,EAAE,4CAA4C,EAAE,mBAAmB;IACtE,QAAQ,EAAE,4CAA4C,EAAE,wBAAwB;IAChF,QAAQ,EAAE,4CAA4C,EAAE,wBAAwB;IAChF,SAAS,EAAE,4CAA4C,EAAE,YAAY;IACrE,IAAI,EAAE,4CAA4C,EAAE,oBAAoB;IACxE,MAAM,EAAE,8CAA8C,EAAE,qBAAqB;CAChF,CAAA;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB,0DAA0D;IAC1D,0CAA0C;CAC7C,CAAA"}
+{"version":3,"file":"nativeBridgeTypes.js","sourceRoot":"","sources":["../../../src/bridge/nativeBridgeTypes.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAU,CAAA;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,CAAU,CAAA;AA8FrD,2BAA2B;AAC3B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,KAAK;IACL,SAAS;IACT,KAAK;IACL,UAAU;IACV,UAAU;IACV,WAAW;IACX,MAAM;CACA,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,CAAU,CAAA;AAExD,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,QAAQ,EAAE,4CAA4C,EAAE,eAAe;IACvE,OAAO,EAAE,4CAA4C,EAAE,cAAc;IACrE,GAAG,EAAE,4CAA4C,EAAE,mBAAmB;IACtE,QAAQ,EAAE,4CAA4C,EAAE,wBAAwB;IAChF,QAAQ,EAAE,4CAA4C,EAAE,wBAAwB;IAChF,SAAS,EAAE,4CAA4C,EAAE,YAAY;IACrE,IAAI,EAAE,4CAA4C,EAAE,oBAAoB;IACxE,MAAM,EAAE,8CAA8C,EAAE,qBAAqB;CAChF,CAAA;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB,0DAA0D;IAC1D,0CAA0C;CAC7C,CAAA"}

package/build/d402/client/types.d.ts

@@ -3,11 +3,14 @@
  * Client-side types for HTTP 402 payment protocol implementation
  */
 /**
- * Payment requirement from 402 response
+ * Payment requirement from 402 response.
+ *
+ * P4 dual-shape: `amount` may be a JS `number` (pre-fork DEM) or a
+ * decimal-`string` (post-fork OS).
  */
 export interface D402PaymentRequirement {
-    /** Payment amount in smallest unit */
-    amount: number;
+    /** Payment amount: pre-fork `number` DEM or post-fork `string` OS. */
+    amount: number | string;
     /** Merchant/recipient address */
     recipient: string;
     /** Resource identifier */

package/build/d402/server/D402Server.d.ts

@@ -4,6 +4,31 @@
  * Handles payment verification and content gating for Demos Network applications.
  */
 import type { D402ServerConfig, D402PaymentRequirement, D402VerificationResult } from './types';
+/**
+ * Normalise a D402 dual-shape amount carrier to OS `bigint`.
+ *
+ * The carrier widened in P4 to `number | string` so a single requirement
+ * object can be served by both pre-fork (DEM `number`) and post-fork
+ * (OS decimal `string`) nodes. Naïve `<` comparison on this union is
+ * unsafe: string-vs-string is lexicographic ("5000000000" < "5" === true)
+ * and number/string mixes coerce through `Number(...)` which loses
+ * precision above 2^53. Both failure modes can wrongly accept
+ * underpayment or reject valid payment.
+ *
+ * - `number` input: treated as DEM (legacy wire) and converted to OS
+ *   via `demToOs`. Negative or non-finite numbers throw.
+ * - `string` input: treated as a canonical OS decimal-integer string
+ *   and parsed via `parseOsString`. Non-canonical strings (whitespace,
+ *   leading zeros, signed prefix) throw.
+ *
+ * The throw is intentional — D402 amount fields cross a trust boundary
+ * (the requirement set by the merchant, the verified amount returned
+ * by the node) and a malformed value is a configuration error, not a
+ * silent default.
+ *
+ * @internal exported for tests; not part of the public D402 API.
+ */
+export declare function _normalizeD402AmountToOsBigint(value: number | string | bigint): bigint;
 export declare class D402Server {
     private rpcUrl;
     private cacheTTL;

package/build/d402/server/D402Server.js

@@ -3,6 +3,53 @@
  *
  * Handles payment verification and content gating for Demos Network applications.
  */
+import { demToOs, parseOsString } from '../../denomination/index.js';
+/**
+ * Normalise a D402 dual-shape amount carrier to OS `bigint`.
+ *
+ * The carrier widened in P4 to `number | string` so a single requirement
+ * object can be served by both pre-fork (DEM `number`) and post-fork
+ * (OS decimal `string`) nodes. Naïve `<` comparison on this union is
+ * unsafe: string-vs-string is lexicographic ("5000000000" < "5" === true)
+ * and number/string mixes coerce through `Number(...)` which loses
+ * precision above 2^53. Both failure modes can wrongly accept
+ * underpayment or reject valid payment.
+ *
+ * - `number` input: treated as DEM (legacy wire) and converted to OS
+ *   via `demToOs`. Negative or non-finite numbers throw.
+ * - `string` input: treated as a canonical OS decimal-integer string
+ *   and parsed via `parseOsString`. Non-canonical strings (whitespace,
+ *   leading zeros, signed prefix) throw.
+ *
+ * The throw is intentional — D402 amount fields cross a trust boundary
+ * (the requirement set by the merchant, the verified amount returned
+ * by the node) and a malformed value is a configuration error, not a
+ * silent default.
+ *
+ * @internal exported for tests; not part of the public D402 API.
+ */
+export function _normalizeD402AmountToOsBigint(value) {
+    if (typeof value === 'bigint') {
+        if (value < 0n) {
+            throw new Error(`[D402Server] amount must be non-negative, got ${value}`);
+        }
+        return value;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new Error(`[D402Server] amount must be a non-negative finite number, got ${value}`);
+        }
+        // demToOs accepts integer or fractional DEM; for D402 a fractional
+        // DEM number is valid (the legacy wire allowed sub-DEM numerics
+        // in some indexer paths) so we don't add an extra is-integer guard
+        // here.
+        return demToOs(value);
+    }
+    if (typeof value === 'string') {
+        return parseOsString(value);
+    }
+    throw new Error(`[D402Server] amount must be number | string | bigint, got ${typeof value}`);
+}
 export class D402Server {
     constructor(config) {
         this.rpcUrl = config.rpcUrl;
@@ -119,8 +166,22 @@ export class D402Server {
         if (verification.verified_to !== requirement.recipient) {
             return false;
         }
-        // Check amount matches (or exceeds)
-        if (verification.verified_amount < requirement.amount) {
+        // Check amount matches (or exceeds). BigInt-normalise both sides
+        // so the dual-shape (number DEM | string OS) carrier works
+        // correctly: lexicographic string compare and Number() coercion
+        // both produce wrong answers on real-world OS magnitudes.
+        // A malformed amount here is a configuration / RPC-corruption
+        // bug — fail closed and return false rather than throwing the
+        // exception across the middleware.
+        try {
+            const verifiedOs = _normalizeD402AmountToOsBigint(verification.verified_amount);
+            const requiredOs = _normalizeD402AmountToOsBigint(requirement.amount);
+            if (verifiedOs < requiredOs) {
+                return false;
+            }
+        }
+        catch (err) {
+            console.error('[D402Server] amount comparison failed:', err);
             return false;
         }
         // Check resource ID in memo (format: "resourceId:xyz")

package/build/d402/server/D402Server.js.map

@@ -1 +1 @@
-{"version":3,"file":"D402Server.js","sourceRoot":"","sources":["../../../../src/d402/server/D402Server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"D402Server.js","sourceRoot":"","sources":["../../../../src/d402/server/D402Server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,8BAA8B,CAC1C,KAA+B;IAE/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACX,iDAAiD,KAAK,EAAE,CAC3D,CAAA;QACL,CAAC;QACD,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACX,iEAAiE,KAAK,EAAE,CAC3E,CAAA;QACL,CAAC;QACD,mEAAmE;QACnE,gEAAgE;QAChE,mEAAmE;QACnE,QAAQ;QACR,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IACD,MAAM,IAAI,KAAK,CACX,6DAA6D,OAAO,KAAK,EAAE,CAC9E,CAAA;AACL,CAAC;AAED,MAAM,OAAO,UAAU;IAKnB,YAAY,MAAwB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC3B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAA,CAAC,oBAAoB;QAC3D,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACvB,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO;gBACH,KAAK,EAAE,IAAI;gBACX,aAAa,EAAE,MAAM,CAAC,IAAI;gBAC1B,WAAW,EAAE,MAAM,CAAC,EAAE;gBACtB,eAAe,EAAE,MAAM,CAAC,MAAM;gBAC9B,aAAa,EAAE,MAAM,CAAC,IAAI;gBAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC9B,CAAA;QACL,CAAC;QAED,6BAA6B;QAC7B,6DAA6D;QAC7D,8DAA8D;QAC9D,uDAAuD;QAEvD,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,iBAAiB,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aACzC,CAAC,CAAA;YAEF,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACxB,CAAA;YACL,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAA;YAElC,yBAAyB;YACzB,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,cAAc,EAAE;gBAC7D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;aAC5C,CAAC,CAAA;YAEF,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;gBACrB,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACxB,CAAA;YACL,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAA;YAEhD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;gBACrB,2CAA2C;gBAC3C,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACtC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAA;gBAEnC,6BAA6B;gBAC7B,MAAM,aAAa,GAAkB;oBACjC,MAAM;oBACN,IAAI,EAAE,YAAY,CAAC,aAAa;oBAChC,EAAE,EAAE,YAAY,CAAC,WAAW;oBAC5B,MAAM,EAAE,YAAY,CAAC,eAAe;oBACpC,IAAI;oBACJ,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;iBACjD,CAAA;gBACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;gBAE5C,OAAO;oBACH,KAAK,EAAE,IAAI;oBACX,aAAa,EAAE,YAAY,CAAC,aAAa;oBACzC,WAAW,EAAE,YAAY,CAAC,WAAW;oBACrC,eAAe,EAAE,YAAY,CAAC,eAAe;oBAC7C,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,YAAY,CAAC,SAAS;iBACpC,CAAA;YACL,CAAC;YAED,OAAO;gBACH,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAA;QAEL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAA;YACvD,OAAO;gBACH,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAA;QACL,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,WAAmC;QAIvC,OAAO;YACH,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,WAAW;SACpB,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACH,eAAe,CACX,YAAoC,EACpC,WAAmC;QAEnC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,0BAA0B;QAC1B,IAAI,YAAY,CAAC,WAAW,KAAK,WAAW,CAAC,SAAS,EAAE,CAAC;YACrD,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,iEAAiE;QACjE,2DAA2D;QAC3D,gEAAgE;QAChE,0DAA0D;QAC1D,8DAA8D;QAC9D,8DAA8D;QAC9D,mCAAmC;QACnC,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,8BAA8B,CAC7C,YAAY,CAAC,eAA2C,CAC3D,CAAA;YACD,MAAM,UAAU,GAAG,8BAA8B,CAC7C,WAAW,CAAC,MAAkC,CACjD,CAAA;YACD,IAAI,UAAU,GAAG,UAAU,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAA;YAChB,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAA;YAC5D,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,uDAAuD;QACvD,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,IAAI,EAAE,CAAA;QAC7C,MAAM,kBAAkB,GAAG,cAAc,WAAW,CAAC,UAAU,EAAE,CAAA;QAEjE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,OAAO,IAAI,CAAA;IACf,CAAC;IAED;;OAEG;IACK,UAAU;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAClC,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACN,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;CACJ"}

package/build/d402/server/middleware.d.ts

@@ -3,11 +3,14 @@
  * Express-compatible middleware for HTTP 402 payment gating
  */
 /**
- * Middleware configuration options
+ * Middleware configuration options.
+ *
+ * P4 dual-shape: `amount` may be a JS `number` (pre-fork DEM) or a
+ * decimal-`string` (post-fork OS).
  */
 export interface D402MiddlewareOptions {
-    /** Payment amount in smallest unit */
-    amount: number;
+    /** Payment amount: pre-fork `number` DEM or post-fork `string` OS. */
+    amount: number | string;
     /** Resource identifier (included in memo validation) */
     resourceId: string;
     /** Demos Network RPC URL */
@@ -29,7 +32,7 @@ export interface D402Request {
     d402Payment?: {
         from: string;
         to: string;
-        amount: number;
+        amount: number | string;
         txHash: string;
     };
 }

package/build/d402/server/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../src/d402/server/middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../src/d402/server/middleware.ts"],"names":[],"mappings":"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"}

package/build/d402/server/types.d.ts

@@ -3,11 +3,15 @@
  * Server-side types for HTTP 402 payment protocol implementation
  */
 /**
- * Payment requirements sent in 402 response
+ * Payment requirements sent in 402 response.
+ *
+ * P4 dual-shape: `amount` may be a JS `number` (pre-fork DEM) or a
+ * decimal-`string` (post-fork OS). SDK consumers should normalise via
+ * `BigInt(...)` before arithmetic.
  */
 export interface D402PaymentRequirement {
-    /** Payment amount in smallest unit */
-    amount: number;
+    /** Payment amount in DEM (number) or OS (decimal string). */
+    amount: number | string;
     /** Merchant/recipient address */
     recipient: string;
     /** Resource identifier (used in memo validation) */
@@ -16,13 +20,16 @@ export interface D402PaymentRequirement {
     description?: string;
 }
 /**
- * Payment verification result from RPC
+ * Payment verification result from RPC.
+ *
+ * P4 dual-shape: `verified_amount` may arrive as a JS `number` (pre-fork
+ * DEM) or a decimal-`string` (post-fork OS).
  */
 export interface D402VerificationResult {
     valid: boolean;
     verified_from?: string;
     verified_to?: string;
-    verified_amount?: number;
+    verified_amount?: number | string;
     verified_memo?: string;
     timestamp: number;
 }
@@ -36,13 +43,14 @@ export interface D402ServerConfig {
     cacheTTL?: number;
 }
 /**
- * Cached payment data
+ * Cached payment data. `amount` follows the dual-shape rule (number DEM
+ * pre-fork, decimal-string OS post-fork).
  */
 export interface CachedPayment {
     txHash: string;
     from: string;
     to: string;
-    amount: number;
+    amount: number | string;
     memo: string;
     timestamp: number;
     expiresAt: number;

package/build/denomination/conversion.test.js

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "@jest/globals";
 import { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion.js";
 // REVIEW: P0 foundation — verbatim test suite from IDEA.md §0.5 plus three
 // edge-case tests called out in the P0 task brief.

package/build/denomination/conversion.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.test.js","sourceRoot":"","sources":["../../../src/denomination/conversion.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversion.test.js","sourceRoot":"","sources":["../../../src/denomination/conversion.test.ts"],"names":[],"mappings":"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"}

package/build/denomination/index.d.ts

@@ -8,3 +8,6 @@
  */
 export { OS_DECIMALS, OS_PER_DEM, MIN_AMOUNT_OS, ZERO_OS, } from "./constants";
 export { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion";
+export { serializeTransactionContent } from "./serializerGate";
+export type { ForkStatus, NetworkInfo } from "./networkInfo";
+export { SubDemPrecisionError } from "./networkInfo";

package/build/denomination/index.js

@@ -9,4 +9,10 @@
 // REVIEW: P0 foundation — barrel export for the new denomination module.
 export { OS_DECIMALS, OS_PER_DEM, MIN_AMOUNT_OS, ZERO_OS, } from "./constants.js";
 export { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion.js";
+// REVIEW: P4 commit 2 — dual-format serializer (internal infrastructure).
+// Exported through `denomination` so consumers can compute SDK-shaped
+// hashes for off-line workflows; the primary use is internal to
+// `Demos.sign`.
+export { serializeTransactionContent } from "./serializerGate.js";
+export { SubDemPrecisionError } from "./networkInfo.js";
 //# sourceMappingURL=index.js.map

package/build/denomination/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/denomination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AAEzE,OAAO,EACH,WAAW,EACX,UAAU,EACV,aAAa,EACb,OAAO,GACV,MAAM,aAAa,CAAA;AAEpB,OAAO,EACH,OAAO,EACP,OAAO,EACP,aAAa,EACb,UAAU,EACV,SAAS,GACZ,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/denomination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AAEzE,OAAO,EACH,WAAW,EACX,UAAU,EACV,aAAa,EACb,OAAO,GACV,MAAM,aAAa,CAAA;AAEpB,OAAO,EACH,OAAO,EACP,OAAO,EACP,aAAa,EACb,UAAU,EACV,SAAS,GACZ,MAAM,cAAc,CAAA;AAErB,0EAA0E;AAC1E,sEAAsE;AACtE,gEAAgE;AAChE,gBAAgB;AAChB,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAK9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/build/denomination/networkInfo.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Fork-detection types and the sub-DEM precision error.
+ *
+ * Shape mirrors the node's `libs/network/handlers/forkHandlers.ts`
+ * response — this is the wire contract for the `getNetworkInfo`
+ * `nodeCall`. Wrapping the per-fork status under `forks.<name>` makes
+ * adding a future fork a strictly additive change.
+ *
+ * @module denomination/networkInfo
+ */
+/** Per-fork status entry. */
+export interface ForkStatus {
+    /**
+     * Configured activation height for the fork. `null` means the fork
+     * is configured but unscheduled (the SDK should treat this as
+     * "fork will not activate during this RPC's lifetime").
+     */
+    activationHeight: number | null;
+    /**
+     * Whether the fork's rules are currently active on the node.
+     * Computed by the canonical `isForkActive` gate node-side; the SDK
+     * uses this directly without recomputing.
+     */
+    activated: boolean;
+    /**
+     * In-memory cache of the latest block height the node has
+     * processed. Lets clients do their own near-fork detection without
+     * an extra `getLastBlockNumber` call.
+     */
+    currentHeight: number;
+}
+/**
+ * Response shape for the `getNetworkInfo` `nodeCall`.
+ *
+ * The SDK only consults `forks.osDenomination.activated` for serializer
+ * routing; the rest of the payload is exposed for callers that want to
+ * surface near-fork warnings to their users.
+ */
+export interface NetworkInfo {
+    forks: {
+        osDenomination: ForkStatus;
+    };
+}
+/**
+ * Thrown by `Demos.transfer` (and friends) when a caller passes an OS
+ * amount with sub-DEM precision against a node that has not yet
+ * activated the `osDenomination` fork. The pre-fork wire shape is a JS
+ * `number` in DEM, which cannot represent sub-DEM precision; sending
+ * the transaction would silently truncate the user's funds. This guard
+ * fails fast at the public-API boundary before any signing happens.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await demos.transfer(to, 1_234_567n) // sub-DEM precision
+ * } catch (err) {
+ *   if (err instanceof SubDemPrecisionError) {
+ *     // tell the user to round, or to upgrade the node
+ *   }
+ * }
+ * ```
+ */
+export declare class SubDemPrecisionError extends Error {
+    /** Full OS amount the caller attempted to send. */
+    readonly amountOs: bigint;
+    /** Truncated remainder: `amountOs % OS_PER_DEM`. */
+    readonly subDemRemainderOs: bigint;
+    constructor(amountOs: bigint, subDemRemainderOs: bigint);
+}

package/build/denomination/networkInfo.js

@@ -0,0 +1,38 @@
+/**
+ * Fork-detection types and the sub-DEM precision error.
+ *
+ * Shape mirrors the node's `libs/network/handlers/forkHandlers.ts`
+ * response — this is the wire contract for the `getNetworkInfo`
+ * `nodeCall`. Wrapping the per-fork status under `forks.<name>` makes
+ * adding a future fork a strictly additive change.
+ *
+ * @module denomination/networkInfo
+ */
+/**
+ * Thrown by `Demos.transfer` (and friends) when a caller passes an OS
+ * amount with sub-DEM precision against a node that has not yet
+ * activated the `osDenomination` fork. The pre-fork wire shape is a JS
+ * `number` in DEM, which cannot represent sub-DEM precision; sending
+ * the transaction would silently truncate the user's funds. This guard
+ * fails fast at the public-API boundary before any signing happens.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await demos.transfer(to, 1_234_567n) // sub-DEM precision
+ * } catch (err) {
+ *   if (err instanceof SubDemPrecisionError) {
+ *     // tell the user to round, or to upgrade the node
+ *   }
+ * }
+ * ```
+ */
+export class SubDemPrecisionError extends Error {
+    constructor(amountOs, subDemRemainderOs) {
+        super(`Cannot send amount ${amountOs} OS to a pre-fork node: sub-DEM precision (${subDemRemainderOs} OS) would be silently truncated. The target node must upgrade to support OS-denomination before this transaction can be sent.`);
+        this.name = "SubDemPrecisionError";
+        this.amountOs = amountOs;
+        this.subDemRemainderOs = subDemRemainderOs;
+    }
+}
+//# sourceMappingURL=networkInfo.js.map

package/build/denomination/networkInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkInfo.js","sourceRoot":"","sources":["../../../src/denomination/networkInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyCH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAM3C,YAAY,QAAgB,EAAE,iBAAyB;QACnD,KAAK,CACD,sBAAsB,QAAQ,8CAA8C,iBAAiB,gIAAgI,CAChO,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAA;IAC9C,CAAC;CACJ"}

package/build/denomination/networkInfo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/denomination/networkInfo.test.js

@@ -0,0 +1,28 @@
+import { describe, test, expect } from "@jest/globals";
+import { SubDemPrecisionError } from "./networkInfo.js";
+import { OS_PER_DEM } from "./constants.js";
+// REVIEW: P4 commit 3 — public-API guard tests. The actual
+// `Demos.getNetworkInfo` / `_isPostForkCached` round-trip is exercised
+// in src/tests/forkDetection.spec.ts because it needs the full Demos
+// class wired with a stubbed nodeCall.
+describe("SubDemPrecisionError", () => {
+    test("carries the offending OS amount and the truncated remainder", () => {
+        const amountOs = 1234567890n;
+        const remainder = amountOs % OS_PER_DEM; // 234_567_890n
+        const err = new SubDemPrecisionError(amountOs, remainder);
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(SubDemPrecisionError);
+        expect(err.name).toBe("SubDemPrecisionError");
+        expect(err.amountOs).toBe(amountOs);
+        expect(err.subDemRemainderOs).toBe(remainder);
+        expect(err.message).toContain("1234567890 OS");
+        expect(err.message).toContain("234567890 OS");
+        expect(err.message).toContain("pre-fork node");
+    });
+    test("instanceof works after JSON-like construction", () => {
+        const err = new SubDemPrecisionError(1n, 1n);
+        expect(err instanceof SubDemPrecisionError).toBe(true);
+        expect(err instanceof Error).toBe(true);
+    });
+});
+//# sourceMappingURL=networkInfo.test.js.map

package/build/denomination/networkInfo.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkInfo.test.js","sourceRoot":"","sources":["../../../src/denomination/networkInfo.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,2DAA2D;AAC3D,uEAAuE;AACvE,qEAAqE;AACrE,uCAAuC;AAEvC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAG,WAAc,CAAA;QAC/B,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA,CAAC,eAAe;QACvD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QACzD,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAA;QAChD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;QAC9C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,YAAY,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/build/denomination/roundTripHash.test.d.ts

@@ -0,0 +1 @@
+export {};