@kynesyslabs/demosdk 2.12.1 → 3.1.0

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

@@ -1,3 +1,25 @@
+/**
+ * Snapshot of an address's on-chain state.
+ *
+ * P4: `balance` is `bigint`. The magnitude depends on the connected
+ * node's fork status:
+ *
+ * - **Post-fork**: the node returns balance in **OS** (smallest unit,
+ *   1 DEM = 10^9 OS). The SDK passes this through unchanged.
+ * - **Pre-fork**: the node returns balance in **DEM**. The SDK passes
+ *   this through unchanged — it does **not** auto-convert client-side.
+ *
+ * Consumers that need to do arithmetic in OS regardless of node version
+ * should branch on `demos.getNetworkInfo()` (or the internal
+ * `_isPostForkCached`) and call `denomination.demToOs(balance)` only
+ * on the pre-fork branch. For display, use `denomination.osToDem(balance)`
+ * post-fork or treat the value as DEM directly pre-fork.
+ *
+ * (Earlier drafts of this doc claimed the SDK multiplied pre-fork
+ * balances client-side via `osToDem`; that was inaccurate on both
+ * counts — `osToDem` divides, and the SDK does not multiply at all.
+ * Fixed in PR-86 review.)
+ */
 export interface AddressInfo {
     pubkey: string;
     assignedTxs: string[];
@@ -6,5 +28,6 @@ export interface AddressInfo {
         web2: Map<string, string[]>;
     };
     nonce: number;
+    /** Address balance, `bigint` in OS (smallest unit). */
     balance: bigint;
 }

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

@@ -1,4 +1,13 @@
 import { TransactionContent } from "./Transaction";
+/**
+ * Raw transaction row as it surfaces from the node's storage layer.
+ *
+ * Wire-format compatibility note (P4): `amount`, `networkFee`, `rpcFee`, and
+ * `additionalFee` may arrive as either JS `number` (pre-fork node, DEM) or
+ * decimal `string` (post-fork node, OS). Consumers must coerce via
+ * `denomination.parseOsString` / `BigInt(...)` before doing arithmetic;
+ * never call raw `Number(...)` once OS-magnitude values are possible.
+ */
 export interface RawTransaction {
     id: number;
     blockNumber: number;
@@ -9,12 +18,12 @@ export interface RawTransaction {
     type: TransactionContent["type"];
     from: any;
     to: any;
-    amount: number;
+    amount: number | string;
     nonce: number;
     timestamp: number;
-    networkFee: number;
-    rpcFee: number;
-    additionalFee: number;
+    networkFee: number | string;
+    rpcFee: number | string;
+    additionalFee: number | string;
     ed25519_signature: string;
     from_ed25519_address: string;
 }

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

@@ -1,6 +1,14 @@
+/**
+ * Native chain status snapshot for an address.
+ *
+ * Wire-format compatibility (P4): `balance` may arrive as a JS `number`
+ * (pre-fork node, DEM) or a decimal `string` (post-fork node, OS).
+ * Consumers should normalise via `BigInt(...)` to OS internally before
+ * arithmetic. Direct `Number(balance)` truncates above 2^53.
+ */
 export interface StatusNative {
     address: string;
-    balance: number;
+    balance: number | string;
     nonce: number;
     tx_list: string;
 }

package/build/types/bridge/bridgeTradePayload.d.ts

@@ -1,7 +1,7 @@
 export interface BridgeTradePayload {
     fromToken: "NATIVE" | "USDC" | "USDT";
     toToken: "NATIVE" | "USDC" | "USDT";
-    amount: number;
+    amount: number | string;
     fromChainId: number;
     toChainId: number;
 }

package/build/types/gls/StateChange.d.ts

@@ -1,17 +1,43 @@
 import forge from "node-forge";
+/**
+ * Indexer-style state change record. Wire-format compatibility (P4):
+ * `nativeAmount`, `TokenTransfer.amount`, and `NFTTransfer.amount` may
+ * arrive as JS `number` (pre-fork DEM) or decimal `string` (post-fork OS).
+ *
+ * Consumers should normalise via the denomination helpers, **not**
+ * `BigInt(...)`, because:
+ *
+ * - `BigInt(numberWithFractional)` throws `RangeError`.
+ * - `BigInt("non-numeric")` throws `SyntaxError`.
+ * - `BigInt(...)` does not validate decimal-string OS canonicality —
+ *   indexer responses can arrive with whitespace, leading zeros, or
+ *   signed-integer notation.
+ *
+ * Recommended:
+ *
+ * - `denomination.parseOsString(value)` for OS decimal-string inputs
+ *   (post-fork wire). Strips noise and validates the integer shape.
+ * - `denomination.demToOs(value)` for DEM `number` inputs (pre-fork
+ *   wire). Validates and converts to OS bigint.
+ *
+ * Branch on the source's known fork status (e.g. via
+ * `demos.getNetworkInfo()`), not on `typeof value` — the literal `"5"`
+ * could be either a pre-fork DEM string or a post-fork OS string,
+ * which differ by a factor of 10^9.
+ */
 interface TokenTransfer {
     address: string;
-    amount: number;
+    amount: number | string;
 }
 interface NFTTransfer {
     address: string;
     tokenId: string;
-    amount: number;
+    amount: number | string;
 }
 export interface StateChange {
     sender: forge.pki.ed25519.BinaryBuffer;
     receiver: forge.pki.ed25519.BinaryBuffer;
-    nativeAmount: number;
+    nativeAmount: number | string;
     tx_hash: string;
     token: TokenTransfer;
     nft: NFTTransfer;

package/build/types/index.d.ts

@@ -4,7 +4,7 @@ export { ISignature } from "./blockchain/ISignature";
 export { RawTransaction } from "./blockchain/rawTransaction";
 export { Transaction, TransactionContent, TransactionContentData, } from "./blockchain/Transaction";
 export { type CustomCharges, type IPFSCustomCharges, type IPFSCostBreakdown, type ValidityDataCustomCharges, hasIPFSCustomCharges, isValidCharge, } from "./blockchain/CustomCharges";
-export { L2PSTransaction, Web2Transaction, CrosschainTransaction, NativeTransaction, DemosworkTransaction, IdentityTransaction, InstantMessagingTransaction, NativeBridgeTransaction, SpecificTransaction, IPFSTransaction, type IPFSTransactionContent, type IPFSPayload, type IPFSAddPayload, type IPFSPinPayload, type IPFSUnpinPayload, type IPFSExtendPinPayload, type IPFSOperationType, isIPFSAddPayload, isIPFSPinPayload, isIPFSUnpinPayload, isIPFSExtendPinPayload, isIPFSPayload, } from "./blockchain/TransactionSubtypes";
+export { L2PSTransaction, Web2Transaction, CrosschainTransaction, NativeTransaction, DemosworkTransaction, IdentityTransaction, InstantMessagingTransaction, NativeBridgeTransaction, SpecificTransaction, IPFSTransaction, type IPFSTransactionContent, type IPFSPayload, type IPFSAddPayload, type IPFSPinPayload, type IPFSUnpinPayload, type IPFSExtendPinPayload, type IPFSOperationType, isIPFSAddPayload, isIPFSPinPayload, isIPFSUnpinPayload, isIPFSExtendPinPayload, isIPFSPayload, ValidatorStakeTransaction, ValidatorStakePayload, ValidatorUnstakeTransaction, ValidatorUnstakePayload, ValidatorExitTransaction, ValidatorExitPayload, NetworkUpgradeTransaction, NetworkUpgradePayload, NetworkUpgradeVoteTransaction, NetworkUpgradeVotePayload, } from "./blockchain/TransactionSubtypes";
 export { INativePayload } from "./native/INativePayload";
 export { InstantMessagingPayload } from "./instantMessaging";
 export { TxFee } from "./blockchain/TxFee";
@@ -30,7 +30,9 @@ export { DataTypes, operators } from "./demoswork/datatypes";
 export { ConditionalOperationScript, DemosWorkOperationScripts, OperationScript, OperationType, } from "./demoswork/operations";
 export { ICondition, Conditional, StepOutputKey, WorkStepInput, XmStepResult, stepKeys, stepKeysEnum, } from "./demoswork/steps";
 export { BrowserRequest, ConsensusRequest, RPCRequest, RPCResponse, HelloPeerRequest, NodeCall, VoteRequest, RPCResponseWithValidityData, emptyResponse as RPCResponseSkeleton, } from "./communication/rpc";
-export { GCREdit, GCREditAssign, GCREditAssignIdentity, GCREditBalance, GCREditIdentity, GCREditNonce, GCREditSubnetsTx, GCREditStorageProgram, Web2GCRData, XmGCRData, XmGCRIdentityData, } from "./blockchain/GCREdit";
+export { GCREdit, GCREditAssign, GCREditAssignIdentity, GCREditBalance, GCREditIdentity, GCREditNonce, GCREditSubnetsTx, GCREditStorageProgram, GCREditValidatorStake, GCREditNetworkUpgrade, GCREditNetworkUpgradeVote, Web2GCRData, XmGCRData, XmGCRIdentityData, } from "./blockchain/GCREdit";
+export { type ValidatorInfo, type ValidatorStatus, } from "./validator/ValidatorTypes";
+export { type NetworkParameters, type NetworkParameterKey, type NetworkUpgradeProposal, type ProposalStatus, type ProposalVoteInfo, } from "./blockchain/NetworkParameters";
 export { BridgeTradePayload } from "./bridge/bridgeTradePayload";
 export { ChainProviders, SupportedChains, SupportedTokens, } from "./bridge/constants";
 export { type SigningAlgorithm, type EncryptionAlgorithm } from "./cryptography";

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAmBA,gEAAgE;AAChE,OAAO,EAKH,oBAAoB,EACpB,aAAa,GAChB,MAAM,4BAA4B,CAAA;AAEnC,wCAAwC;AACxC,OAAO,EAoBH,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB;AAClB,6CAA6C;AAC7C,sBAAsB,EACtB,aAAa,GAChB,MAAM,kCAAkC,CAAA;AASzC,OAAO,EAAE,aAAa,EAAgB,MAAM,2BAA2B,CAAA;AA6CvE,OAAO;AACP,OAAO,EAaH,eAAe,GAClB,MAAM,QAAQ,CAAA;AAef,OAAO,EAAE,SAAS,EAAa,MAAM,uBAAuB,CAAA;AAO5D,OAAO,EAKH,YAAY,EAEZ,YAAY,GACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EASH,aAAa,IAAI,mBAAmB,GACvC,MAAM,qBAAqB,CAAA;AAgB5B,OAAO,EACH,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAA;AAY3B,+BAA+B;AAC/B,OAAO,EACH,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,wCAAwC,CAAA;AAmB/C,sEAAsE;AACtE,OAAO;AAgCH,oBAAoB;AACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,cAAc,EACd,aAAa,GAChB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAmBA,gEAAgE;AAChE,OAAO,EAKH,oBAAoB,EACpB,aAAa,GAChB,MAAM,4BAA4B,CAAA;AAEnC,wCAAwC;AACxC,OAAO,EAoBH,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB;AAClB,6CAA6C;AAC7C,sBAAsB,EACtB,aAAa,GAahB,MAAM,kCAAkC,CAAA;AASzC,OAAO,EAAE,aAAa,EAAgB,MAAM,2BAA2B,CAAA;AA6CvE,OAAO;AACP,OAAO,EAaH,eAAe,GAClB,MAAM,QAAQ,CAAA;AAef,OAAO,EAAE,SAAS,EAAa,MAAM,uBAAuB,CAAA;AAO5D,OAAO,EAKH,YAAY,EAEZ,YAAY,GACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EASH,aAAa,IAAI,mBAAmB,GACvC,MAAM,qBAAqB,CAAA;AA8B5B,OAAO,EACH,cAAc,EACd,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAA;AAY3B,+BAA+B;AAC/B,OAAO,EACH,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,wCAAwC,CAAA;AAmB/C,sEAAsE;AACtE,OAAO;AAgCH,oBAAoB;AACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,cAAc,EACd,aAAa,GAChB,MAAM,SAAS,CAAA"}

package/build/types/native/INativePayload.d.ts

@@ -1,6 +1,11 @@
 interface INativeSend {
     nativeOperation: "send";
-    args: [string, number];
+    /**
+     * `[to, amount]`. P4 dual-shape: `amount` may be a JS `number` (pre-fork
+     * DEM) or decimal `string` (post-fork OS). Internal arithmetic uses
+     * `bigint` OS via `denomination` utilities.
+     */
+    args: [string, number | string];
 }
 interface INativeTlsnRequest {
     nativeOperation: "tlsn_request";

package/build/types/validator/ValidatorTypes.d.ts

@@ -0,0 +1,13 @@
+/** Status codes written into the Validators table. */
+export type ValidatorStatus = "0" | "2" | "3";
+/** What `getValidatorInfo` / `getValidators` return per row. */
+export interface ValidatorInfo {
+    address: string;
+    status: ValidatorStatus | string;
+    connectionUrl: string | null;
+    stakedAmount: string;
+    firstSeen: number | null;
+    validAt: number | null;
+    unstakeRequestedAt: number | null;
+    unstakeAvailableAt: number | null;
+}

package/build/types/validator/ValidatorTypes.js

@@ -0,0 +1,3 @@
+// Validator state as exposed by the node's RPC surface.
+export {};
+//# sourceMappingURL=ValidatorTypes.js.map

package/build/types/validator/ValidatorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorTypes.js","sourceRoot":"","sources":["../../../../src/types/validator/ValidatorTypes.ts"],"names":[],"mappings":"AAAA,wDAAwD"}

package/build/wallet/Wallet.d.ts

@@ -21,7 +21,33 @@ export default class Wallet {
     load(filename: string): Promise<void>;
     save(filename: string): Promise<void>;
     getBalance(): Promise<void>;
-    transfer(to: Address, amount: number, demos: websdk.Demos): Promise<RPCResponseWithValidityData>;
+    /**
+     * Transfer native DEM tokens to a recipient address.
+     *
+     * P4 dual-input:
+     *  - `bigint` (preferred, post-v3): OS amount. 1 DEM = 10^9 OS.
+     *  - `number` (deprecated, v2 callers): DEM amount, auto-converted.
+     *
+     * Internal carrier is OS bigint; the serializerGate (run from
+     * `demos.sign`) chooses pre-fork vs post-fork wire encoding from
+     * the cached `getNetworkInfo` fork status. Sub-DEM precision
+     * against a pre-fork node throws `SubDemPrecisionError` from
+     * `demos.pay` before any tx construction happens — we delegate to
+     * `demos.pay` which carries the guard.
+     *
+     * @example
+     * ```ts
+     * import { denomination, websdk, wallet } from "@kynesyslabs/demosdk"
+     * const w = wallet.default.getInstance("alice")
+     * await w.transfer("0x...", denomination.demToOs(100), demos)
+     * await w.transfer("0x...", 100_000_000_000n, demos)  // raw OS
+     * ```
+     *
+     * @param to - Recipient address (0x-prefixed hex).
+     * @param amount - DEM `number` (legacy) or OS `bigint`.
+     * @param demos - Demos client used to sign and submit.
+     */
+    transfer(to: Address, amount: number | bigint, demos: websdk.Demos): Promise<RPCResponseWithValidityData>;
     broadcast(validityData: RPCResponseWithValidityData, demos: websdk.Demos): Promise<any>;
     generatePasskey(): Promise<string>;
 }

package/build/wallet/Wallet.js

@@ -1,6 +1,5 @@
 // TODO & REVIEW See if the fs methods are useful in this context or nah (also the public ip)
 import * as websdk from "../websdk/index.js";
-import { DemosTransactions } from "../websdk/index.js";
 import { PasskeyGenerator } from "./passkeys/passkeys.js";
 import { Cryptography } from "../encryption/Cryptography.js";
 class Wallet {
@@ -49,23 +48,37 @@ class Wallet {
     }
     /* SECTION Basic writes */
     // NOTE All the writes return a validity object that needs to be confirmed and broadcasted
+    /**
+     * Transfer native DEM tokens to a recipient address.
+     *
+     * P4 dual-input:
+     *  - `bigint` (preferred, post-v3): OS amount. 1 DEM = 10^9 OS.
+     *  - `number` (deprecated, v2 callers): DEM amount, auto-converted.
+     *
+     * Internal carrier is OS bigint; the serializerGate (run from
+     * `demos.sign`) chooses pre-fork vs post-fork wire encoding from
+     * the cached `getNetworkInfo` fork status. Sub-DEM precision
+     * against a pre-fork node throws `SubDemPrecisionError` from
+     * `demos.pay` before any tx construction happens — we delegate to
+     * `demos.pay` which carries the guard.
+     *
+     * @example
+     * ```ts
+     * import { denomination, websdk, wallet } from "@kynesyslabs/demosdk"
+     * const w = wallet.default.getInstance("alice")
+     * await w.transfer("0x...", denomination.demToOs(100), demos)
+     * await w.transfer("0x...", 100_000_000_000n, demos)  // raw OS
+     * ```
+     *
+     * @param to - Recipient address (0x-prefixed hex).
+     * @param amount - DEM `number` (legacy) or OS `bigint`.
+     * @param demos - Demos client used to sign and submit.
+     */
     async transfer(to, amount, demos) {
-        let tx = DemosTransactions.empty();
-        // Putting the right data in the transaction
-        // tx.content.from = keypair.publicKey.toString("hex")
-        tx.content.from = demos.keypair.publicKey.toString("hex");
-        // tx.content.to = to
-        tx.content.type = "native";
-        tx.content.data = [
-            "native",
-            {
-                nativeOperation: "send",
-                args: [to, amount],
-            },
-        ];
-        // tx.content.amount = amount
-        tx = await demos.sign(tx);
-        // Sending the transaction and getting the validity data
+        // Delegate to demos.pay so we get the sub-DEM guard, the
+        // serializerGate, and the canonical native-send tx shape (with
+        // nonce, timestamp, gcr_edits, fee derivation) for free.
+        const tx = await demos.pay(to, amount);
         return await demos.confirm(tx);
     }
     // TODO Implement other methods too

package/build/wallet/Wallet.js.map

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

package/build/websdk/DemosTransactions.d.ts

@@ -1,5 +1,6 @@
 import { Demos } from "./demosclass";
 import type { SigningAlgorithm, Transaction } from "../types";
+import type { NetworkParameters } from "../types/blockchain/NetworkParameters";
 import { IKeyPair } from "./types/KeyPair";
 import { RPCResponse, RPCResponseWithValidityData } from "../types/communication/rpc";
 export declare const DemosTransactions: {
@@ -8,23 +9,49 @@ export declare const DemosTransactions: {
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
      *
+     * P4 dual-input:
+     *  - `bigint`: OS amount (preferred — 1 DEM = 10^9 OS).
+     *  - `number`: DEM amount (legacy, deprecated). Auto-converted to OS.
+     *
+     * Internal carrier in `tx.content.amount` is bigint OS; the
+     * serializerGate (run from `demos.sign`) emits the right wire shape
+     * per the connected node's fork status.
+     *
      * @param to - The reciever
-     * @param amount - The amount in DEM
+     * @param amount - DEM `number` (legacy) or OS `bigint`.
      * @param demos - The demos instance (for getting the address nonce)
      *
      * @returns The signed transaction.
      */
-    pay(to: string, amount: number, demos: Demos): Promise<Transaction>;
+    pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+    /**
+     * Convert a legacy DEM `number` input to an OS `bigint` for internal
+     * carrying. Only whole-DEM `number` inputs are accepted on this
+     * legacy path — fractional DEM is rejected with a clear error
+     * directing callers to the bigint OS path (`denomination.demToOs`).
+     *
+     * Rationale: silently flooring (the previous behaviour) discarded up
+     * to ~10^9 OS per call without warning. The migration period
+     * tolerates legacy `number` callers, but only at exact DEM
+     * granularity — anything sub-DEM must come in as `bigint` so the
+     * caller has explicitly opted into OS arithmetic.
+     *
+     * @internal
+     */
+    _demNumberToOsBigint(amountDem: number): bigint;
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
      *
+     * Alias of {@link pay}. Same dual-input semantics — `bigint` OS
+     * preferred, `number` DEM accepted as the deprecated path.
+     *
      * @param to - The reciever
-     * @param amount - The amount in DEM
+     * @param amount - DEM `number` (legacy) or OS `bigint`.
      * @param demos - The demos instance (for getting the address nonce)
      *
      * @returns The signed transaction.
      */
-    transfer(to: string, amount: number, demos: Demos): Promise<Transaction>;
+    transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
     /**
      * Signs a transaction after hashing its content.
      *
@@ -144,4 +171,51 @@ export declare const DemosTransactions: {
      * ```
      */
     createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
+    /**
+     * Create a signed `validatorStake` transaction. Used both for initial
+     * validator registration and to top up an existing stake.
+     *
+     * @param amount - Stake amount in base-unit DEMOS, encoded as a bigint string.
+     * @param connectionUrl - Validator's public endpoint (required on first stake;
+     *                        subsequent top-ups may overwrite it).
+     * @param demos - The demos instance (for nonce + signing).
+     */
+    stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
+    /**
+     * Create a signed `validatorUnstake` transaction. Arms the unstake lock
+     * period; after `UNSTAKE_LOCK_BLOCKS` have elapsed the validator may call
+     * `validatorExit`.
+     */
+    unstake(demos: Demos): Promise<Transaction>;
+    /**
+     * Create a signed `validatorExit` transaction. Only accepted by the
+     * network once `unstake_available_at <= currentBlock`.
+     */
+    validatorExit(demos: Demos): Promise<Transaction>;
+    /**
+     * Create a signed `networkUpgrade` proposal transaction.
+     *
+     * Only active validators may propose. The node rejects proposals whose
+     * `proposedParameters` violate safety bounds (≤50% change, absolute
+     * floor/ceiling) or overlap keys with other pending/activating proposals.
+     *
+     * @param params.proposalId - UUID. Also used as lexicographic activation-order tiebreaker.
+     * @param params.proposedParameters - Subset of NetworkParameters to change.
+     * @param params.rationale - Human-readable reason, ≤1024 bytes.
+     * @param params.effectiveAtBlock - Activation block. Must be ≥ tallyBlock + grace period.
+     */
+    proposeNetworkUpgrade(params: {
+        proposalId: string;
+        proposedParameters: Partial<NetworkParameters>;
+        rationale: string;
+        effectiveAtBlock: number;
+    }, demos: Demos): Promise<Transaction>;
+    /**
+     * Create a signed `networkUpgradeVote` transaction.
+     *
+     * The voter must be in the validator snapshot taken at the proposal's
+     * confirmation block, and may cast exactly one vote per proposal (final,
+     * non-revocable).
+     */
+    voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
 };