@kynesyslabs/demosdk 2.12.1 → 3.1.0

package/build/types/blockchain/CustomCharges.d.ts

@@ -5,33 +5,40 @@
  * before execution. Used in the confirm/execute two-step transaction flow
  * to provide cost transparency.
  *
- * @fileoverview Custom charges type definitions for cost estimation
+ * @fileoverview Custom charges type definitions for cost estimation.
+ *
+ * P4 denomination migration:
+ *   All cost fields are bigint-as-decimal-`string` in **OS** (smallest
+ *   unit, 1 DEM = 10^9 OS). Field names changed from `*_dem` to `*_os` to
+ *   reflect the new denomination. Pre-fork-compatible bridges should
+ *   serialise these via the SDK's `serializerGate`, which converts to
+ *   the legacy DEM-`number` shape for pre-fork nodes.
  */
 /**
  * Cost breakdown for IPFS operations
  *
  * Provides detailed cost calculation components so users can understand
- * what they're paying for.
+ * what they're paying for. All values are decimal-string OS amounts.
  */
 export interface IPFSCostBreakdown {
-    /** Base cost for the operation in DEM wei */
+    /** Base cost for the operation, decimal-string OS. */
     base_cost: string;
-    /** Cost based on file size in DEM wei */
+    /** Cost based on file size, decimal-string OS. */
     size_cost: string;
-    /** Cost based on storage duration in DEM wei (optional for indefinite pins) */
+    /** Cost based on storage duration, decimal-string OS (optional for indefinite pins). */
     duration_cost?: string;
-    /** Any additional costs (network fees, etc.) */
+    /** Any additional costs (network fees, etc.) — decimal-string OS values. */
     additional_costs?: Record<string, string>;
 }
 /**
  * IPFS custom charges configuration
  *
  * Included in transaction content to specify maximum cost user agrees to pay.
- * Node will validate that actual cost does not exceed max_cost_dem.
+ * Node will validate that actual cost does not exceed `max_cost_os`.
  */
 export interface IPFSCustomCharges {
-    /** Maximum cost user is willing to pay (in DEM wei as string for BigInt safety) */
-    max_cost_dem: string;
+    /** Maximum cost user is willing to pay, decimal-string OS (BigInt-safe). */
+    max_cost_os: string;
     /** File size in bytes - used for cost calculation validation */
     file_size_bytes: number;
     /** IPFS operation type */
@@ -54,7 +61,7 @@ export interface IPFSCustomCharges {
  *     // ... other fields
  *     custom_charges: {
  *         ipfs: {
- *             max_cost_dem: "1000000000000000000",
+ *             max_cost_os: "1000000000",  // 1 DEM in OS
  *             file_size_bytes: 1024,
  *             operation: "IPFS_ADD"
  *         }
@@ -70,14 +77,16 @@ export interface CustomCharges {
  *
  * Returned by confirmTx to show actual costs vs maximum user agreed to pay.
  * Allows user to review and abort if actual cost is higher than expected.
+ *
+ * All cost fields are decimal-string OS.
  */
 export interface ValidityDataCustomCharges {
     /** Charge type identifier */
     type: "ipfs_storage" | "ipfs_bandwidth" | "compute" | string;
-    /** What user signed as maximum (from TX custom_charges) */
-    max_cost_dem: string;
-    /** What node will actually charge (must be <= max_cost_dem) */
-    actual_cost_dem: string;
+    /** What user signed as maximum (from TX `custom_charges`), decimal-string OS. */
+    max_cost_os: string;
+    /** What node will actually charge (must be `<= max_cost_os`), decimal-string OS. */
+    actual_cost_os: string;
     /** Detailed breakdown of actual costs */
     breakdown: IPFSCostBreakdown;
 }
@@ -88,6 +97,9 @@ export declare function hasIPFSCustomCharges(charges: CustomCharges | undefined)
     ipfs: IPFSCustomCharges;
 };
 /**
- * Validate that actual cost does not exceed maximum
+ * Validate that actual cost does not exceed maximum.
+ *
+ * Inputs are decimal-string OS amounts; both must parse cleanly as
+ * non-negative bigints.
  */
-export declare function isValidCharge(maxCostDem: string, actualCostDem: string): boolean;
+export declare function isValidCharge(maxCostOs: string, actualCostOs: string): boolean;

package/build/types/blockchain/CustomCharges.js

@@ -5,7 +5,14 @@
  * before execution. Used in the confirm/execute two-step transaction flow
  * to provide cost transparency.
  *
- * @fileoverview Custom charges type definitions for cost estimation
+ * @fileoverview Custom charges type definitions for cost estimation.
+ *
+ * P4 denomination migration:
+ *   All cost fields are bigint-as-decimal-`string` in **OS** (smallest
+ *   unit, 1 DEM = 10^9 OS). Field names changed from `*_dem` to `*_os` to
+ *   reflect the new denomination. Pre-fork-compatible bridges should
+ *   serialise these via the SDK's `serializerGate`, which converts to
+ *   the legacy DEM-`number` shape for pre-fork nodes.
  */
 // ============================================================================
 // Type Guards
@@ -17,12 +24,15 @@ export function hasIPFSCustomCharges(charges) {
     return charges?.ipfs !== undefined;
 }
 /**
- * Validate that actual cost does not exceed maximum
+ * Validate that actual cost does not exceed maximum.
+ *
+ * Inputs are decimal-string OS amounts; both must parse cleanly as
+ * non-negative bigints.
  */
-export function isValidCharge(maxCostDem, actualCostDem) {
+export function isValidCharge(maxCostOs, actualCostOs) {
     try {
-        const max = BigInt(maxCostDem);
-        const actual = BigInt(actualCostDem);
+        const max = BigInt(maxCostOs);
+        const actual = BigInt(actualCostOs);
         return actual <= max;
     }
     catch {

package/build/types/blockchain/CustomCharges.js.map

@@ -1 +1 @@
-{"version":3,"file":"CustomCharges.js","sourceRoot":"","sources":["../../../../src/types/blockchain/CustomCharges.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2GH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAAkC;IAElC,OAAO,OAAO,EAAE,IAAI,KAAK,SAAS,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,UAAkB,EAClB,aAAqB;IAErB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;QACpC,OAAO,MAAM,IAAI,GAAG,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC"}
+{"version":3,"file":"CustomCharges.js","sourceRoot":"","sources":["../../../../src/types/blockchain/CustomCharges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6GH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAAkC;IAElC,OAAO,OAAO,EAAE,IAAI,KAAK,SAAS,CAAA;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CACzB,SAAiB,EACjB,YAAoB;IAEpB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;QACnC,OAAO,MAAM,IAAI,GAAG,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC"}

package/build/types/blockchain/GCREdit.d.ts

@@ -1,13 +1,32 @@
 import { IdentityAttestationPayload, IdentityCommitmentPayload, PqcIdentityRemovePayload, UDIdentityPayload, XMCoreTargetIdentityPayload, NomisWalletIdentity, HumanPassportIdentityData, EthosWalletIdentity, TLSNIdentityContext, TLSNProofRanges } from "../abstraction";
 import { SigningAlgorithm } from "../cryptography";
+/**
+ * Balance-mutation GCR edit — adds to or subtracts from a sender/receiver
+ * balance, or burns a fee.
+ *
+ * Wire-format compatibility (P4): `amount` may be either a JS `number`
+ * (pre-fork node, DEM) or a decimal `string` in OS (post-fork node). The
+ * SDK's `GCRGeneration` populates the field with whichever shape matches
+ * the connected node's fork status.
+ *
+ * Important: the node's post-fork serializer (`forks/serializerGate.ts`)
+ * does **not** re-encode `gcr_edits[].amount`. Whatever the SDK puts here
+ * **is** the wire format and contributes directly to the transaction
+ * hash. Construction-site correctness is the contract.
+ */
 export interface GCREditBalance {
     type: "balance";
     isRollback: boolean;
     operation: "add" | "remove";
     account: string;
-    amount: number;
+    amount: number | string;
     txhash: string;
 }
+/**
+ * Nonce-increment GCR edit. `amount` is a counter delta, not a token
+ * amount — always `1` in current code. Kept as `number` because the fork
+ * does not change its encoding. Do **not** confuse with `GCREditBalance.amount`.
+ */
 export interface GCREditNonce {
     type: "nonce";
     isRollback: boolean;
@@ -137,7 +156,12 @@ export interface GCREditEscrow {
         sender?: string;
         platform?: "twitter" | "github" | "telegram";
         username?: string;
-        amount?: number;
+        /**
+         * Escrow deposit amount. Wire format follows the same pre-fork /
+         * post-fork rule as `GCREditBalance.amount`: `number` DEM
+         * pre-fork, decimal `string` OS post-fork.
+         */
+        amount?: number | string;
         expiryDays?: number;
         message?: string;
         claimant?: string;
@@ -166,4 +190,57 @@ export interface GCREditTLSNotary {
     txhash: string;
     isRollback: boolean;
 }
-export type GCREdit = GCREditBalance | GCREditNonce | GCREditAssign | GCREditAssignIdentity | GCREditSubnetsTx | GCREditIdentity | GCREditSmartContract | GCREditStorageProgram | GCREditEscrow | GCREditTLSNotary;
+/**
+ * Validator-staking GCR edit. Emitted by validatorStake / validatorUnstake /
+ * validatorExit transactions. Applied against the Validators table.
+ */
+export interface GCREditValidatorStake {
+    type: "validatorStake";
+    isRollback: boolean;
+    account: string;
+    operation: "stake" | "unstake" | "exit";
+    amount: string;
+    connectionUrl?: string;
+    txhash: string;
+}
+/**
+ * Stackable-genesis governance GCR edit — proposal lifecycle.
+ * Emitted by `networkUpgrade` transactions. Applied to the
+ * `network_upgrades` table at block-confirmation time on every node.
+ *
+ * Carries only client-derivable fields. Server-derived fields
+ * (`version`, `snapshotBlock`, `tallyBlock`) are filled at apply time
+ * by `GCRNetworkUpgradeRoutines.applyProposal` so the edit hash is
+ * deterministic from tx content alone (matches between SDK
+ * `GCRGeneration.generate()` and node-side `handleValidateTransaction`
+ * comparison).
+ */
+export interface GCREditNetworkUpgrade {
+    type: "networkUpgrade";
+    isRollback: boolean;
+    account: string;
+    proposalId: string;
+    proposedParameters: Record<string, unknown>;
+    rationale: string;
+    effectiveAtBlock: number;
+    txhash: string;
+}
+/**
+ * Stackable-genesis governance GCR edit — vote.
+ * Emitted by `networkUpgradeVote` transactions. Applied to the
+ * `network_upgrade_votes` table at block-confirmation time on every node.
+ *
+ * `weight` and `blockNumber` are server-derived at apply time —
+ * voter's snapshotted staked amount + the block number being confirmed.
+ * Keeping them out of the signed edit means the edit hash is
+ * deterministic from tx content alone and matches across SDK + server.
+ */
+export interface GCREditNetworkUpgradeVote {
+    type: "networkUpgradeVote";
+    isRollback: boolean;
+    account: string;
+    proposalId: string;
+    approve: boolean;
+    txhash: string;
+}
+export type GCREdit = GCREditBalance | GCREditNonce | GCREditAssign | GCREditAssignIdentity | GCREditSubnetsTx | GCREditIdentity | GCREditSmartContract | GCREditStorageProgram | GCREditEscrow | GCREditTLSNotary | GCREditValidatorStake | GCREditNetworkUpgrade | GCREditNetworkUpgradeVote;

package/build/types/blockchain/NetworkParameters.d.ts

@@ -0,0 +1,54 @@
+/** Tunable network parameters — the actual config values at runtime. */
+export interface NetworkParameters {
+    /** Target block time in ms. (Phase 2 — consensus-affecting) */
+    blockTimeMs: number;
+    /** Default shard size for consensus. (Phase 2 — consensus-affecting) */
+    shardSize: number;
+    /** Minimum DEMOS to become a validator. bigint-as-string. */
+    minValidatorStake: string;
+    /** Default network fee, basis points [0, 5000]. */
+    networkFee: number;
+    /** Default RPC fee, basis points [0, 5000]. */
+    rpcFee: number;
+    /** Feature flags — string key → boolean. */
+    featureFlags: Record<string, boolean>;
+}
+export type NetworkParameterKey = keyof NetworkParameters;
+export type ProposalStatus = "pending" | "approved" | "activating" | "active" | "rejected";
+/** A proposal to change a subset of NetworkParameters. */
+export interface NetworkUpgradeProposal {
+    /** Monotonic, human-readable label. Assigned at proposal time as max(existing) + 1. */
+    version: number;
+    /** UUID. Dedup key AND lexicographic activation-order tiebreaker. */
+    proposalId: string;
+    /** Proposer's public key (hex). Must be an active validator at snapshotBlock. */
+    proposerPublicKey: string;
+    /** Only the keys the proposer wants to change. */
+    proposedParameters: Partial<NetworkParameters>;
+    /** Activation block. Must be >= tallyBlock + gracePeriodBlocks. */
+    effectiveAtBlock: number;
+    /** Human-readable reason. <= 1024 bytes. */
+    rationale: string;
+    status: ProposalStatus;
+    /** Block at which the proposal tx was confirmed. Freezes validator set + stakes. */
+    snapshotBlock: number;
+}
+/** Per-proposal vote-tally summary. */
+export interface ProposalVoteInfo {
+    proposalId: string;
+    /** Total staked weight of ALL snapshot validators (bigint-as-string). */
+    totalStakedWeight: string;
+    /** Staked weight of voters who approved (bigint-as-string). */
+    approveWeight: string;
+    /** Staked weight of voters who rejected (bigint-as-string). */
+    rejectWeight: string;
+    votes: Array<{
+        voter: string;
+        approve: boolean;
+        weight: string;
+    }>;
+    /** 2/3 of totalStakedWeight (bigint-as-string). */
+    threshold: string;
+    /** True iff approveWeight >= threshold. */
+    passed: boolean;
+}

package/build/types/blockchain/NetworkParameters.js

@@ -0,0 +1,9 @@
+// Stackable-genesis governance types. Canonical spec:
+// planning/adversarial_review/stackable_genesis_system_v2.md in the node repo.
+//
+// These types are the payload shape for governance transactions + the return
+// shape of governance-query RPCs. They intentionally do not include
+// implementation-level DB columns; the node entities may carry additional
+// fields (createdAt, tally_block, etc.).
+export {};
+//# sourceMappingURL=NetworkParameters.js.map

package/build/types/blockchain/NetworkParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkParameters.js","sourceRoot":"","sources":["../../../../src/types/blockchain/NetworkParameters.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,0EAA0E;AAC1E,yCAAyC"}

package/build/types/blockchain/Transaction.d.ts

@@ -18,14 +18,32 @@ import { D402PaymentPayload } from "./TransactionSubtypes/D402PaymentTransaction
 import { EscrowPayload } from "./TransactionSubtypes/EscrowTransaction";
 import { IPFSPayload } from "./TransactionSubtypes/IPFSTransaction";
 import { TokenCreationPayload, TokenExecutionPayload } from "./TransactionSubtypes/TokenTransaction";
+import { ValidatorStakePayload } from "./TransactionSubtypes/ValidatorStakeTransaction";
+import { ValidatorUnstakePayload } from "./TransactionSubtypes/ValidatorUnstakeTransaction";
+import { ValidatorExitPayload } from "./TransactionSubtypes/ValidatorExitTransaction";
+import { NetworkUpgradePayload } from "./TransactionSubtypes/NetworkUpgradeTransaction";
+import { NetworkUpgradeVotePayload } from "./TransactionSubtypes/NetworkUpgradeVoteTransaction";
 import { CustomCharges } from "./CustomCharges";
-export type TransactionContentData = ["web2Request", IWeb2Payload] | ["crosschainOperation", XMScript] | ["native", INativePayload] | ["demoswork", DemoScript] | ["l2psEncryptedTx", L2PSEncryptedPayload] | ["identity", IdentityPayload] | ["instantMessaging", InstantMessagingPayload] | ["l2psInstantMessaging", L2PSInstantMessagingPayload] | ["nativeBridge", NativeBridgeTxPayload] | ["storage", StoragePayload] | ["storageProgram", StorageProgramPayload] | ["l2ps_hash_update", L2PSHashPayload] | ["contractDeploy", ContractDeployPayload] | ["contractCall", ContractCallPayload] | ["d402_payment", D402PaymentPayload] | ["escrow", EscrowPayload] | ["ipfs", IPFSPayload] | ["tokenCreation", TokenCreationPayload] | ["tokenExecution", TokenExecutionPayload];
+export type TransactionContentData = ["web2Request", IWeb2Payload] | ["crosschainOperation", XMScript] | ["native", INativePayload] | ["demoswork", DemoScript] | ["l2psEncryptedTx", L2PSEncryptedPayload] | ["identity", IdentityPayload] | ["instantMessaging", InstantMessagingPayload] | ["l2psInstantMessaging", L2PSInstantMessagingPayload] | ["nativeBridge", NativeBridgeTxPayload] | ["storage", StoragePayload] | ["storageProgram", StorageProgramPayload] | ["l2ps_hash_update", L2PSHashPayload] | ["contractDeploy", ContractDeployPayload] | ["contractCall", ContractCallPayload] | ["d402_payment", D402PaymentPayload] | ["escrow", EscrowPayload] | ["ipfs", IPFSPayload] | ["tokenCreation", TokenCreationPayload] | ["tokenExecution", TokenExecutionPayload] | ["validatorStake", ValidatorStakePayload] | ["validatorUnstake", ValidatorUnstakePayload] | ["validatorExit", ValidatorExitPayload] | ["networkUpgrade", NetworkUpgradePayload] | ["networkUpgradeVote", NetworkUpgradeVotePayload];
 export interface TransactionContent {
-    type: "web2Request" | "crosschainOperation" | "subnet" | "native" | "demoswork" | "genesis" | "NODE_ONLINE" | "identity" | "instantMessaging" | "l2psInstantMessaging" | "nativeBridge" | "l2psEncryptedTx" | "storage" | "storageProgram" | "l2ps_hash_update" | "contractDeploy" | "contractCall" | "d402_payment" | "escrow" | "ipfs" | "tokenCreation" | "tokenExecution";
+    type: "web2Request" | "crosschainOperation" | "subnet" | "native" | "demoswork" | "genesis" | "NODE_ONLINE" | "identity" | "instantMessaging" | "l2psInstantMessaging" | "nativeBridge" | "l2psEncryptedTx" | "storage" | "storageProgram" | "l2ps_hash_update" | "contractDeploy" | "contractCall" | "d402_payment" | "escrow" | "ipfs" | "tokenCreation" | "tokenExecution" | "validatorStake" | "validatorUnstake" | "validatorExit" | "networkUpgrade" | "networkUpgradeVote";
     from: string;
     from_ed25519_address: string;
     to: string;
-    amount: number;
+    /**
+     * Native DEM amount transferred by this transaction.
+     *
+     * Wire-format compatibility:
+     * - Pre-fork node: encoded as JS `number` in DEM.
+     * - Post-fork node: encoded as a decimal `string` in OS (1 DEM = 10^9 OS).
+     *
+     * Both shapes are accepted on input; the SDK's `serializerGate`
+     * (P4 commit 2) normalises to the right wire shape per fork status
+     * before signing. SDK-internal arithmetic always uses `bigint` OS via
+     * `denomination` utilities — never raw `number`, which loses precision
+     * above 2^53 OS (~9 million DEM).
+     */
+    amount: number | string;
     data: TransactionContentData;
     gcr_edits: GCREdit[];
     nonce: number;

package/build/types/blockchain/Transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../../../../src/types/blockchain/Transaction.ts"],"names":[],"mappings":"AA4GA,uCAAuC;AACvC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../../../../src/types/blockchain/Transaction.ts"],"names":[],"mappings":"AAwIA,uCAAuC;AACvC,cAAc,uBAAuB,CAAA"}

package/build/types/blockchain/TransactionSubtypes/D402PaymentTransaction.d.ts

@@ -1,13 +1,18 @@
 import { Transaction, TransactionContent } from "../Transaction";
 /**
  * D402 Payment Payload
- * Represents a gasless payment transaction in the D402 protocol
+ * Represents a gasless payment transaction in the D402 protocol.
+ *
+ * Wire-format compatibility (P4): `amount` may be either a JS `number`
+ * (pre-fork DEM, legacy) or a decimal `string` in OS (post-fork). The
+ * SDK's serializerGate normalises at the wire boundary based on the
+ * connected node's fork status.
  */
 export interface D402PaymentPayload {
     /** Recipient's Demos address */
     to: string;
-    /** Payment amount in smallest unit */
-    amount: number;
+    /** Payment amount: pre-fork `number` (DEM) or post-fork `string` (OS). */
+    amount: number | string;
     /** Optional memo/description for the payment */
     memo?: string;
 }

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeTransaction.d.ts

@@ -0,0 +1,20 @@
+import { Transaction, TransactionContent } from "../Transaction";
+import type { NetworkParameters } from "../NetworkParameters";
+/** Payload for a `networkUpgrade` proposal tx. */
+export interface NetworkUpgradePayload {
+    /** UUID chosen by the proposer — used as dedup key and activation-order tiebreaker. */
+    proposalId: string;
+    /** Only the keys the proposer wants to change. */
+    proposedParameters: Partial<NetworkParameters>;
+    /** Human-readable reason. <= 1024 bytes. */
+    rationale: string;
+    /** Block at which approved upgrades activate. Must respect the grace period. */
+    effectiveAtBlock: number;
+}
+export type NetworkUpgradeTransactionContent = Omit<TransactionContent, 'type' | 'data'> & {
+    type: 'networkUpgrade';
+    data: ['networkUpgrade', NetworkUpgradePayload];
+};
+export interface NetworkUpgradeTransaction extends Omit<Transaction, 'content'> {
+    content: NetworkUpgradeTransactionContent;
+}

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NetworkUpgradeTransaction.js.map

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkUpgradeTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/NetworkUpgradeTransaction.ts"],"names":[],"mappings":""}

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeVoteTransaction.d.ts

@@ -0,0 +1,13 @@
+import { Transaction, TransactionContent } from "../Transaction";
+/** Payload for a `networkUpgradeVote` tx. One vote per validator per proposal; final. */
+export interface NetworkUpgradeVotePayload {
+    proposalId: string;
+    approve: boolean;
+}
+export type NetworkUpgradeVoteTransactionContent = Omit<TransactionContent, 'type' | 'data'> & {
+    type: 'networkUpgradeVote';
+    data: ['networkUpgradeVote', NetworkUpgradeVotePayload];
+};
+export interface NetworkUpgradeVoteTransaction extends Omit<Transaction, 'content'> {
+    content: NetworkUpgradeVoteTransactionContent;
+}

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeVoteTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NetworkUpgradeVoteTransaction.js.map

package/build/types/blockchain/TransactionSubtypes/NetworkUpgradeVoteTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkUpgradeVoteTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/NetworkUpgradeVoteTransaction.ts"],"names":[],"mappings":""}

package/build/types/blockchain/TransactionSubtypes/StorageProgramTransaction.d.ts

@@ -1,14 +1,15 @@
 import { Transaction, TransactionContent } from "../Transaction";
-/**
- * Storage Program constants for validation and pricing
- */
 export declare const STORAGE_PROGRAM_CONSTANTS: {
     /** Maximum storage size in bytes (1MB) */
     readonly MAX_SIZE_BYTES: 1048576;
     /** Size chunk for pricing in bytes (10KB) */
     readonly PRICING_CHUNK_BYTES: 10240;
-    /** Fee per chunk in DEM */
-    readonly FEE_PER_CHUNK: 1n;
+    /**
+     * Fee per chunk, expressed in OS (= 1 DEM = 10^9 OS).
+     * Use bigint arithmetic at every call site; the SDK never widens
+     * back to JS `number`, which loses precision above 2^53.
+     */
+    readonly FEE_PER_CHUNK: bigint;
     /** Maximum nesting depth for JSON encoding */
     readonly MAX_JSON_NESTING_DEPTH: 64;
 };

package/build/types/blockchain/TransactionSubtypes/StorageProgramTransaction.js

@@ -3,15 +3,27 @@
 // Constants
 // ============================================================================
 /**
- * Storage Program constants for validation and pricing
+ * Storage Program constants for validation and pricing.
+ *
+ * P4 fix: prior to this revision `FEE_PER_CHUNK` was hard-coded as `1n`,
+ * which represented "1 OS" (the smallest unit) — off by `10^9` from the
+ * intended "1 DEM per chunk" pricing. Now expressed as `OS_PER_DEM` to
+ * make the unit explicit and the pricing correct on the SDK side. (Note:
+ * the node's matching constant must be aligned by P5 to avoid SDK/node
+ * fee-schedule drift — flagged for follow-up.)
  */
+import { OS_PER_DEM } from "../../../denomination/index.js";
 export const STORAGE_PROGRAM_CONSTANTS = {
     /** Maximum storage size in bytes (1MB) */
     MAX_SIZE_BYTES: 1048576,
     /** Size chunk for pricing in bytes (10KB) */
     PRICING_CHUNK_BYTES: 10240,
-    /** Fee per chunk in DEM */
-    FEE_PER_CHUNK: 1n,
+    /**
+     * Fee per chunk, expressed in OS (= 1 DEM = 10^9 OS).
+     * Use bigint arithmetic at every call site; the SDK never widens
+     * back to JS `number`, which loses precision above 2^53.
+     */
+    FEE_PER_CHUNK: OS_PER_DEM,
     /** Maximum nesting depth for JSON encoding */
     MAX_JSON_NESTING_DEPTH: 64,
 };

package/build/types/blockchain/TransactionSubtypes/StorageProgramTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProgramTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/StorageProgramTransaction.ts"],"names":[],"mappings":"AAEA,qFAAqF;AAErF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,0CAA0C;IAC1C,cAAc,EAAE,OAAO;IAEvB,6CAA6C;IAC7C,mBAAmB,EAAE,KAAK;IAE1B,2BAA2B;IAC3B,aAAa,EAAE,EAAE;IAEjB,8CAA8C;IAC9C,sBAAsB,EAAE,EAAE;CACpB,CAAA;AA0OV,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACpD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzD,MAAM,CAAC,GAAG,OAAkC,CAAA;IAC5C,MAAM,eAAe,GAAG;QACpB,wBAAwB;QACxB,eAAe;QACf,cAAc;QACd,uBAAuB;QACvB,wBAAwB;QACxB,sBAAsB;QACtB,WAAW;QACX,UAAU;QACV,aAAa;QACb,cAAc;QACd,aAAa;KAChB,CAAA;IACD,OAAO,CACH,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ;QACpC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAmB,CAAC,CAClD,CAAA;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC7C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAA;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACpD,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,MAAM,CAAA;AACxD,CAAC"}
+{"version":3,"file":"StorageProgramTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/StorageProgramTransaction.ts"],"names":[],"mappings":"AAEA,qFAAqF;AAErF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,0CAA0C;IAC1C,cAAc,EAAE,OAAO;IAEvB,6CAA6C;IAC7C,mBAAmB,EAAE,KAAK;IAE1B;;;;OAIG;IACH,aAAa,EAAE,UAAU;IAEzB,8CAA8C;IAC9C,sBAAsB,EAAE,EAAE;CACpB,CAAA;AA0OV,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACpD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzD,MAAM,CAAC,GAAG,OAAkC,CAAA;IAC5C,MAAM,eAAe,GAAG;QACpB,wBAAwB;QACxB,eAAe;QACf,cAAc;QACd,uBAAuB;QACvB,wBAAwB;QACxB,sBAAsB;QACtB,WAAW;QACX,UAAU;QACV,aAAa;QACb,cAAc;QACd,aAAa;KAChB,CAAA;IACD,OAAO,CACH,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ;QACpC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAmB,CAAC,CAClD,CAAA;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC7C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAA;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACpD,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,MAAM,CAAA;AACxD,CAAC"}

package/build/types/blockchain/TransactionSubtypes/ValidatorExitTransaction.d.ts

@@ -0,0 +1,10 @@
+import { Transaction, TransactionContent } from "../Transaction";
+/** Payload for a `validatorExit` tx. Sender is implicit in the tx envelope. */
+export type ValidatorExitPayload = Record<string, never>;
+export type ValidatorExitTransactionContent = Omit<TransactionContent, 'type' | 'data'> & {
+    type: 'validatorExit';
+    data: ['validatorExit', ValidatorExitPayload];
+};
+export interface ValidatorExitTransaction extends Omit<Transaction, 'content'> {
+    content: ValidatorExitTransactionContent;
+}

package/build/types/blockchain/TransactionSubtypes/ValidatorExitTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ValidatorExitTransaction.js.map

package/build/types/blockchain/TransactionSubtypes/ValidatorExitTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorExitTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/ValidatorExitTransaction.ts"],"names":[],"mappings":""}

package/build/types/blockchain/TransactionSubtypes/ValidatorStakeTransaction.d.ts

@@ -0,0 +1,15 @@
+import { Transaction, TransactionContent } from "../Transaction";
+/** Payload for a `validatorStake` tx. */
+export interface ValidatorStakePayload {
+    /** Stake amount as bigint-encoded string. */
+    amount: string;
+    /** Validator's public-facing connection URL (used on first stake only). */
+    connectionUrl: string;
+}
+export type ValidatorStakeTransactionContent = Omit<TransactionContent, 'type' | 'data'> & {
+    type: 'validatorStake';
+    data: ['validatorStake', ValidatorStakePayload];
+};
+export interface ValidatorStakeTransaction extends Omit<Transaction, 'content'> {
+    content: ValidatorStakeTransactionContent;
+}

package/build/types/blockchain/TransactionSubtypes/ValidatorStakeTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ValidatorStakeTransaction.js.map

package/build/types/blockchain/TransactionSubtypes/ValidatorStakeTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorStakeTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/ValidatorStakeTransaction.ts"],"names":[],"mappings":""}

package/build/types/blockchain/TransactionSubtypes/ValidatorUnstakeTransaction.d.ts

@@ -0,0 +1,10 @@
+import { Transaction, TransactionContent } from "../Transaction";
+/** Payload for a `validatorUnstake` tx. Sender is implicit in the tx envelope. */
+export type ValidatorUnstakePayload = Record<string, never>;
+export type ValidatorUnstakeTransactionContent = Omit<TransactionContent, 'type' | 'data'> & {
+    type: 'validatorUnstake';
+    data: ['validatorUnstake', ValidatorUnstakePayload];
+};
+export interface ValidatorUnstakeTransaction extends Omit<Transaction, 'content'> {
+    content: ValidatorUnstakeTransactionContent;
+}

package/build/types/blockchain/TransactionSubtypes/ValidatorUnstakeTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ValidatorUnstakeTransaction.js.map

package/build/types/blockchain/TransactionSubtypes/ValidatorUnstakeTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorUnstakeTransaction.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/ValidatorUnstakeTransaction.ts"],"names":[],"mappings":""}

package/build/types/blockchain/TransactionSubtypes/index.d.ts

@@ -15,6 +15,11 @@ export * from './D402PaymentTransaction';
 export * from './EscrowTransaction';
 export * from './IPFSTransaction';
 export * from './TokenTransaction';
+export * from './ValidatorStakeTransaction';
+export * from './ValidatorUnstakeTransaction';
+export * from './ValidatorExitTransaction';
+export * from './NetworkUpgradeTransaction';
+export * from './NetworkUpgradeVoteTransaction';
 import { L2PSTransaction } from './L2PSTransaction';
 import { L2PSHashTransaction } from './L2PSHashTransaction';
 import { Web2Transaction } from './Web2Transaction';
@@ -33,4 +38,9 @@ import { EscrowTransaction } from './EscrowTransaction';
 import { IPFSTransaction } from './IPFSTransaction';
 import { TokenCreationTransaction } from './TokenTransaction';
 import { TokenExecutionTransaction } from './TokenTransaction';
-export type SpecificTransaction = L2PSTransaction | L2PSHashTransaction | Web2Transaction | CrosschainTransaction | NativeTransaction | DemosworkTransaction | IdentityTransaction | InstantMessagingTransaction | L2PSInstantMessagingTransaction | NativeBridgeTransaction | StorageTransaction | StorageProgramTransaction | ContractDeployTransaction | ContractCallTransaction | D402PaymentTransaction | EscrowTransaction | IPFSTransaction | TokenCreationTransaction | TokenExecutionTransaction;
+import { ValidatorStakeTransaction } from './ValidatorStakeTransaction';
+import { ValidatorUnstakeTransaction } from './ValidatorUnstakeTransaction';
+import { ValidatorExitTransaction } from './ValidatorExitTransaction';
+import { NetworkUpgradeTransaction } from './NetworkUpgradeTransaction';
+import { NetworkUpgradeVoteTransaction } from './NetworkUpgradeVoteTransaction';
+export type SpecificTransaction = L2PSTransaction | L2PSHashTransaction | Web2Transaction | CrosschainTransaction | NativeTransaction | DemosworkTransaction | IdentityTransaction | InstantMessagingTransaction | L2PSInstantMessagingTransaction | NativeBridgeTransaction | StorageTransaction | StorageProgramTransaction | ContractDeployTransaction | ContractCallTransaction | D402PaymentTransaction | EscrowTransaction | IPFSTransaction | TokenCreationTransaction | TokenExecutionTransaction | ValidatorStakeTransaction | ValidatorUnstakeTransaction | ValidatorExitTransaction | NetworkUpgradeTransaction | NetworkUpgradeVoteTransaction;

package/build/types/blockchain/TransactionSubtypes/index.js

@@ -16,4 +16,11 @@ export * from './EscrowTransaction.js';
 export * from './IPFSTransaction.js';
 // REVIEW: Token transaction types
 export * from './TokenTransaction.js';
+// Validator staking (Phase 0 / upgradable_network)
+export * from './ValidatorStakeTransaction.js';
+export * from './ValidatorUnstakeTransaction.js';
+export * from './ValidatorExitTransaction.js';
+// Stackable-genesis governance (Phase 1 / upgradable_network)
+export * from './NetworkUpgradeTransaction.js';
+export * from './NetworkUpgradeVoteTransaction.js';
 //# sourceMappingURL=index.js.map

package/build/types/blockchain/TransactionSubtypes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,kCAAkC;AAClC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/blockchain/TransactionSubtypes/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,kCAAkC;AAClC,cAAc,oBAAoB,CAAA;AAClC,mDAAmD;AACnD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,8DAA8D;AAC9D,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iCAAiC,CAAA"}

package/build/types/blockchain/TxFee.d.ts

@@ -1,5 +1,18 @@
+/**
+ * Transaction fee container.
+ *
+ * Wire-format compatibility note: pre-fork wire encodes each field as a JS
+ * `number` in DEM. Post-fork wire encodes them as decimal strings in OS
+ * (smallest unit, 1 DEM = 10^9 OS). Both shapes are accepted on input; the
+ * SDK's `serializerGate` (P4 commit 2) is the wire boundary that picks the
+ * correct on-the-wire shape per the connected node's fork status.
+ *
+ * Internally, fee math is performed in `bigint` OS via `denomination`
+ * conversion utilities — never as `number` (which loses precision above
+ * 2^53 OS, ~9 million DEM).
+ */
 export interface TxFee {
-    network_fee: number;
-    rpc_fee: number;
-    additional_fee: number;
+    network_fee: number | string;
+    rpc_fee: number | string;
+    additional_fee: number | string;
 }