@kynesyslabs/demosdk 4.0.12 → 4.0.14

package/build/websdk/Web2Calls.js

@@ -2,6 +2,7 @@ import { EnumWeb2Actions } from "../types/index.js";
 import { web2_request } from "./utils/skeletons.js";
 import { DemosTransactions } from "./DemosTransactions.js";
 import { canonicalJSONStringify, validatePureJson, looksLikeJsonString, } from "./utils/canonicalJson.js";
+import { resolveNonce } from "../utils/index.js";
 class Web2InvalidUrlError extends Error {
     constructor(message, code) {
         super(message);
@@ -134,8 +135,8 @@ export class Web2Proxy {
         web2Tx.content.type = "web2Request";
         web2Tx.content.data = ["web2Request", web2Payload];
         web2Tx.content.timestamp = Date.now();
-        const nonce = await this._demos.getAddressNonce(await this._demos.getEd25519Address());
-        web2Tx.content.nonce = nonce + 1;
+        const nonce = await resolveNonce(options?.nonce, async () => this._demos.getAddressNonce(await this._demos.getEd25519Address()));
+        web2Tx.content.nonce = nonce;
         const signedWeb2Tx = await this._demos.sign(web2Tx);
         const validityData = await this._demos.confirm(signedWeb2Tx);
         const txHash = validityData.response.data.transaction.hash;

package/build/websdk/Web2Calls.js.map

@@ -1 +1 @@
-{"version":3,"file":"Web2Calls.js","sourceRoot":"","sources":["../../../src/websdk/Web2Calls.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Web2Calls.js","sourceRoot":"","sources":["../../../src/websdk/Web2Calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EACH,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,uBAAuB,CAAA;AAO9B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,mBAAoB,SAAQ,KAAK;IAEnC,YAAY,OAAe,EAAE,IAAY;QACrC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;CACJ;AAED,SAAS,0BAA0B,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CACzB,sBAAsB,EACtB,kBAAkB,CACrB,CAAA;IACL,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CACzB,qDAAqD,EACrD,WAAW,CACd,CAAA;IACL,CAAC;IACD,IAAI,CAAM,CAAA;IACV,IAAI,CAAC;QACD,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,mBAAmB,CACzB,oEAAoE,EACpE,aAAa,CAChB,CAAA;IACL,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,mBAAmB,CACzB,oEAAoE,EACpE,aAAa,CAChB,CAAA;IACL,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,mBAAmB,CACzB,iGAAiG,EACjG,aAAa,CAChB,CAAA;IACL,CAAC;IACD,qFAAqF;IACrF,CAAC,CAAC,IAAI,GAAG,EAAE,CAAA;IACX,0BAA0B;IAC1B,IACI,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;QAC3C,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAC/C,CAAC;QACC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAA;IACf,CAAC;IACD,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAA,CAAC,iBAAiB;AACzC,CAAC;AAED,MAAM,OAAO,SAAS;IAIlB,YAAY,SAAiB,EAAE,KAAY;QACvC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACvB,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAA;IAC1B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,EACb,GAAG,EACH,MAAM,EACN,OAAO,GAAG;QACN,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,SAAS;QAClB,aAAa,EAAE,EAAE;KACpB,GACe;QAChB,MAAM,YAAY,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAA;QAEpD,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,EAAE,GAAG,YAAY,EAAE,CAAA;QAE5C,yDAAyD;QACzD,MAAM,aAAa,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAEpE,gBAAgB,CAAC,GAAG,GAAG;YACnB,GAAG,gBAAgB,CAAC,GAAG;YACvB,MAAM,EAAE,eAAe,CAAC,WAAW;YACnC,MAAM;YACN,GAAG,EAAE,YAAY;YACjB,OAAO,EAAE,aAAa;SACzB,CAAA;QAED,4BAA4B;QAC5B,IAAI,gBAAgB,GAAQ,SAAS,CAAA;QACrC,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACtC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACjC,gBAAgB,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBAC1D,0DAA0D;gBAC1D,IACI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,cAAc,CAC1C,EACH,CAAC;oBACC,aAAa,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAA;gBACtD,CAAC;YACL,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7C,oDAAoD;gBACpD,IAAI,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,IAAI,CACR,6IAA6I,CAChJ,CAAA;gBACL,CAAC;gBACD,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAA;YACtC,CAAC;iBAAM,CAAC;gBACJ,kGAAkG;gBAClG,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBAClD,IACI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,cAAc,CAC1C,EACH,CAAC;oBACC,aAAa,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAA;gBACtD,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACxD,WAAW,EAAE,gBAAgB;YAC7B,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,OAAO,EAAE,gBAAgB,EAAE,6BAA6B;YACxD,aAAa,EAAE,OAAO,EAAE,aAAa;SACxC,CAAC,CAAA;QAEF,MAAM,WAAW,GAAiB;YAC9B,OAAO,EAAE;gBACL,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,EAAE;gBACjB,WAAW,EAAE;oBACT,GAAG,gBAAgB;oBACnB,MAAM,EAAE;wBACJ,SAAS,EAAE,IAAI,CAAC,UAAU;wBAC1B,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG;wBACnC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;wBACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;wBAChC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO;wBAClC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;wBAC5C,mBAAmB,EACf,QAAQ,CAAC,QAAQ,CAAC,mBAAmB;wBACzC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW;4BAC7B,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE;4BAChD,CAAC,CAAC,EAAE,CAAC;wBACT,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU;qBAC3C;iBACJ;aACJ;SACJ,CAAA;QAED,oEAAoE;QACpE,MAAM,MAAM,GAAgB,iBAAiB,CAAC,KAAK,EAAE,CAAA;QACrD,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAA;QACzD,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,aAAa,CAAA;QACnC,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;QAClD,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAErC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CACxD,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CACrE,CAAA;QACD,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;QAE5B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QAEzC,MAAM,MAAM,GAAgB;YACxB,GAAG,QAAQ,CAAC,QAAQ;YACpB,MAAM;SACT,CAAA;QACD,OAAO,MAAM,CAAA;IACjB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,KAAY,EAAsB,EAAE;QACnD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAA;QAEjC,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAClE,CAAC;QAED,kDAAkD;QAClD,MAAM,gBAAgB,GAAG,EAAE,GAAG,YAAY,EAAE,CAAA;QAC5C,gBAAgB,CAAC,GAAG,GAAG;YACnB,GAAG,gBAAgB,CAAC,GAAG;YACvB,MAAM,EAAE,eAAe,CAAC,MAAM;SACjC,CAAA;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAClD,WAAW,EAAE,gBAAgB;SAChC,CAAC,CAAA;QAEF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAA;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACrD,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC1C,CAAC;CACJ,CAAA"}

package/build/websdk/demosclass.d.ts

@@ -7,6 +7,7 @@ import type { ValidatorInfo } from "../types/validator/ValidatorTypes";
 import type { NetworkParameters, NetworkUpgradeProposal, ProposalVoteInfo } from "../types/blockchain/NetworkParameters";
 import { RPCRequest, RPCResponse, RPCResponseWithValidityData } from "../types/communication/rpc";
 import { IKeyPair } from "./types/KeyPair";
+import { type ProgrammaticTx } from "./programmatic";
 import { UnifiedCrypto } from "../encryption/unifiedCrypto";
 import { type NetworkInfo } from "../denomination/networkInfo";
 import { TweetSimplified } from "../types";
@@ -67,6 +68,50 @@ export declare class Demos {
      * @returns Whether the connection was successful
      */
     connect(rpc_url: string): Promise<boolean>;
+    /**
+     * One-call bootstrap: connect to a node and (optionally) a wallet, then
+     * return the ready instance for immediate use with `demos.run.*`.
+     *
+     * Convenience wrapper over {@link connect} + {@link connectWallet} — no
+     * new behaviour, just the two-step setup collapsed into one. Omit
+     * `wallet` to connect read-only.
+     *
+     * @example
+     * ```ts
+     * import { Demos } from "@kynesyslabs/demosdk/websdk"
+     * const demos = await Demos.start("https://node2.demos.sh", mnemonic)
+     * await demos.run.pay("0x...", 100n)
+     * ```
+     *
+     * @param rpc_url - The URL of the demos node.
+     * @param wallet - Master seed / mnemonic (string) or raw seed bytes.
+     *                 Omit to connect without a wallet.
+     * @param walletOptions - Forwarded to {@link connectWallet}.
+     * @returns This connected Demos instance.
+     */
+    start(rpc_url: string, wallet?: string | Uint8Array, walletOptions?: {
+        algorithm?: SigningAlgorithm;
+        dual_sign?: boolean;
+    }): Promise<this>;
+    /**
+     * Static one-call bootstrap over the shared singleton — starts
+     * {@link Demos.instance} and returns it ready for `demos.run.*`.
+     *
+     * @example
+     * ```ts
+     * const demos = await Demos.start("https://node2.demos.sh", mnemonic)
+     * await demos.run.pay("0x...", 100n)
+     * ```
+     *
+     * @param rpc_url - The URL of the demos node.
+     * @param wallet - Master seed / mnemonic (string) or raw seed bytes.
+     * @param walletOptions - Forwarded to {@link connectWallet}.
+     * @returns The started shared Demos instance.
+     */
+    static start(rpc_url: string, wallet?: string | Uint8Array, walletOptions?: {
+        algorithm?: SigningAlgorithm;
+        dual_sign?: boolean;
+    }): Promise<Demos>;
     /**
      * Connects to a Demos wallet using the provided master seed.
      *
@@ -133,7 +178,9 @@ export declare class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    pay(to: string, amount: number | bigint): Promise<Transaction>;
+    pay(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
      *
@@ -151,7 +198,9 @@ export declare class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    transfer(to: string, amount: number | bigint): Promise<Transaction>;
+    transfer(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Create a signed DEMOS transaction to store binary data on the blockchain.
      * Data is stored in the sender's account.
@@ -160,7 +209,9 @@ export declare class Demos {
      *
      * @returns The signed storage transaction.
      */
-    store(bytes: Uint8Array): Promise<Transaction>;
+    store(bytes: Uint8Array, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     storagePrograms: {
         /**
          * Creates and signs a storage program transaction given a payload.
@@ -169,7 +220,9 @@ export declare class Demos {
          * @returns The signed transaction
          *
          */
-        sign: (payload: StorageProgramPayload) => Promise<Transaction>;
+        sign: (payload: StorageProgramPayload, options?: {
+            nonce?: number;
+        }) => Promise<Transaction>;
         /**
          * Reads a storage program by address.
          *
@@ -202,7 +255,7 @@ export declare class Demos {
      * handle async confirmation yourself.
      *
      * @param validationData - The validity data of the transaction
-     * @param opts.timeoutMs - Total time to wait. Defaults to 30_000.
+     * @param opts.timeoutMs - Total time to wait. Defaults to 60_000.
      * @param opts.pollIntervalMs - Delay between polls. Defaults to 500.
      */
     broadcastAndWait(validationData: RPCResponseWithValidityData, opts?: {
@@ -222,7 +275,9 @@ export declare class Demos {
      * @param options - The dual-signing options
      * @returns The signed transaction
      */
-    sign(raw_tx: Transaction): Promise<Transaction>;
+    sign(raw_tx: Transaction, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Signs a message.
      *
@@ -619,9 +674,13 @@ export declare class Demos {
         sign: (raw_tx: Transaction) => Promise<Transaction>;
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         signWithAlgorithm: (data: string, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<{
@@ -641,25 +700,78 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
+    private _run?;
+    /**
+     * Programmatic transaction facade — one call per transaction type.
+     *
+     * Collapses the classic `build → sign → confirm → broadcast` flow into a
+     * single method per operation (`run.pay`, `run.attest.*`, `run.tokens.*`,
+     * …) that auto-broadcasts within a configurable fee ceiling (default
+     * 5 DEM). Additive: the classic `pay`/`confirm`/`broadcast` methods are
+     * unchanged.
+     *
+     * Built lazily on first access (and memoised) rather than in the
+     * constructor. Two reasons: (1) the singleton `demos = Demos.instance` is
+     * created at import time, so eagerly *constructing* the namespaces during
+     * `new Demos()` — which reach into `@/abstraction`, tokens, contracts — is
+     * the part that risked tripping the websdk↔abstraction import cycle;
+     * deferring construction removes that crash vector. (2) it avoids building
+     * ~6 objects on every `new Demos()` that many callers never touch.
+     *
+     * Note: the programmatic module graph is still *loaded* when this file is
+     * imported (a static `import` cannot be deferred in ESM). That residual
+     * cycle is benign — no module reads a cross-cycle binding at evaluation
+     * time, only inside functions — and has been narrowed by importing
+     * `Identities` directly from `@/abstraction/Identities` rather than via the
+     * `@/abstraction` barrel.
+     *
+     * @example
+     * ```ts
+     * // one-call payment, auto-broadcast within the 5 DEM fee cap
+     * await demos.run.pay("0x...", 100n)
+     * // build + confirm only, broadcast yourself later
+     * const r = await demos.run.pay("0x...", 100n, { confirm: "manual" })
+     * await demos.broadcast(r.validityData)
+     * ```
+     */
+    get run(): ProgrammaticTx;
     DemosTransactions: {
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         sign: (raw_tx: Transaction, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<Transaction>;
@@ -682,25 +794,43 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
     transactions: {
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         sign: (raw_tx: Transaction, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<Transaction>;
@@ -723,18 +853,32 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
     DemosWebAuth: typeof DemosWebAuth;
     skeletons: typeof skeletons;

package/build/websdk/demosclass.js

@@ -12,10 +12,12 @@ import { DemosWebAuth } from "./DemosWebAuth.js";
 import { prepareXMPayload } from "./XMTransactions.js";
 import { _required as required } from "./utils/required.js";
 import { web2Calls } from "./Web2Calls.js";
+import { createProgrammaticTx, } from "./programmatic/index.js";
 import { hexToUint8Array, uint8ArrayToHex, UnifiedCrypto, } from "../encryption/unifiedCrypto.js";
 import { GCRGeneration } from "./GCRGeneration.js";
 import { Hashing } from "../encryption/Hashing.js";
 import { OS_PER_DEM, demToOs, parseOsString } from "../denomination/index.js";
+import { assertValidNonce, resolveNonce } from "../utils/index.js";
 import { serializeTransactionContent } from "../denomination/serializerGate.js";
 import { SubDemPrecisionError, } from "../denomination/networkInfo.js";
 import * as bip39 from "@scure/bip39";
@@ -87,7 +89,7 @@ export class Demos {
              * @returns The signed transaction
              *
              */
-            sign: async (payload) => {
+            sign: async (payload, options) => {
                 required(this.keypair, "Wallet not connected");
                 required(payload.storageAddress, "Storage address Not found in payload");
                 // Sender's nonce must be set on the tx like every other
@@ -97,13 +99,15 @@ export class Demos {
                 // txs ship with the skeleton default nonce 0 and get rejected
                 // by the node's sequential-nonce / expectedPrior enforcement
                 // after the first one.
-                const { publicKey } = await this.crypto.getIdentity("ed25519");
-                const publicKeyHex = uint8ArrayToHex(publicKey);
-                const nonce = await this.getAddressNonce(publicKeyHex);
+                const nonce = await resolveNonce(options?.nonce, async () => {
+                    const { publicKey } = await this.crypto.getIdentity("ed25519");
+                    const publicKeyHex = uint8ArrayToHex(publicKey);
+                    return this.getAddressNonce(publicKeyHex);
+                });
                 const tx = DemosTransactions.empty();
                 tx.content.to = payload.storageAddress;
                 tx.content.type = "storageProgram";
-                tx.content.nonce = nonce + 1;
+                tx.content.nonce = nonce;
                 tx.content.data = ["storageProgram", payload];
                 return await this.sign(tx);
             },
@@ -276,6 +280,52 @@ export class Demos {
         this.connected = true;
         return this.connected;
     }
+    /**
+     * One-call bootstrap: connect to a node and (optionally) a wallet, then
+     * return the ready instance for immediate use with `demos.run.*`.
+     *
+     * Convenience wrapper over {@link connect} + {@link connectWallet} — no
+     * new behaviour, just the two-step setup collapsed into one. Omit
+     * `wallet` to connect read-only.
+     *
+     * @example
+     * ```ts
+     * import { Demos } from "@kynesyslabs/demosdk/websdk"
+     * const demos = await Demos.start("https://node2.demos.sh", mnemonic)
+     * await demos.run.pay("0x...", 100n)
+     * ```
+     *
+     * @param rpc_url - The URL of the demos node.
+     * @param wallet - Master seed / mnemonic (string) or raw seed bytes.
+     *                 Omit to connect without a wallet.
+     * @param walletOptions - Forwarded to {@link connectWallet}.
+     * @returns This connected Demos instance.
+     */
+    async start(rpc_url, wallet, walletOptions) {
+        await this.connect(rpc_url);
+        if (wallet !== undefined) {
+            await this.connectWallet(wallet, walletOptions);
+        }
+        return this;
+    }
+    /**
+     * Static one-call bootstrap over the shared singleton — starts
+     * {@link Demos.instance} and returns it ready for `demos.run.*`.
+     *
+     * @example
+     * ```ts
+     * const demos = await Demos.start("https://node2.demos.sh", mnemonic)
+     * await demos.run.pay("0x...", 100n)
+     * ```
+     *
+     * @param rpc_url - The URL of the demos node.
+     * @param wallet - Master seed / mnemonic (string) or raw seed bytes.
+     * @param walletOptions - Forwarded to {@link connectWallet}.
+     * @returns The started shared Demos instance.
+     */
+    static async start(rpc_url, wallet, walletOptions) {
+        return Demos.instance.start(rpc_url, wallet, walletOptions);
+    }
     /**
      * Connects to a Demos wallet using the provided master seed.
      *
@@ -389,11 +439,11 @@ export class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    async pay(to, amount) {
+    async pay(to, amount, options) {
         required(this.keypair, "Wallet not connected");
         const amountOs = typeof amount === "bigint" ? amount : demToOs(amount);
         await this._assertAmountAcceptableOnTargetNode(amountOs);
-        return DemosTransactions.pay(to, amountOs, this);
+        return DemosTransactions.pay(to, amountOs, this, options);
     }
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
@@ -412,8 +462,8 @@ export class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    async transfer(to, amount) {
-        return this.pay(to, amount);
+    async transfer(to, amount, options) {
+        return this.pay(to, amount, options);
     }
     /**
      * Create a signed DEMOS transaction to store binary data on the blockchain.
@@ -423,9 +473,9 @@ export class Demos {
      *
      * @returns The signed storage transaction.
      */
-    store(bytes) {
+    store(bytes, options) {
         required(this.keypair, "Wallet not connected");
-        return DemosTransactions.store(bytes, this);
+        return DemosTransactions.store(bytes, this, options);
     }
     /**
      * Confirms a transaction.
@@ -454,7 +504,7 @@ export class Demos {
      * handle async confirmation yourself.
      *
      * @param validationData - The validity data of the transaction
-     * @param opts.timeoutMs - Total time to wait. Defaults to 30_000.
+     * @param opts.timeoutMs - Total time to wait. Defaults to 60_000.
      * @param opts.pollIntervalMs - Delay between polls. Defaults to 500.
      */
     broadcastAndWait(validationData, opts) {
@@ -467,8 +517,11 @@ export class Demos {
      * @param options - The dual-signing options
      * @returns The signed transaction
      */
-    async sign(raw_tx) {
+    async sign(raw_tx, options) {
         required(this.keypair, "Wallet not connected");
+        if (options?.nonce !== undefined) {
+            raw_tx.content.nonce = assertValidNonce(options.nonce);
+        }
         if (!raw_tx.content.timestamp || raw_tx.content.timestamp === 0) {
             raw_tx.content.timestamp = Date.now();
         }
@@ -1417,6 +1470,42 @@ export class Demos {
         }
         return tlsn;
     }
+    /**
+     * Programmatic transaction facade — one call per transaction type.
+     *
+     * Collapses the classic `build → sign → confirm → broadcast` flow into a
+     * single method per operation (`run.pay`, `run.attest.*`, `run.tokens.*`,
+     * …) that auto-broadcasts within a configurable fee ceiling (default
+     * 5 DEM). Additive: the classic `pay`/`confirm`/`broadcast` methods are
+     * unchanged.
+     *
+     * Built lazily on first access (and memoised) rather than in the
+     * constructor. Two reasons: (1) the singleton `demos = Demos.instance` is
+     * created at import time, so eagerly *constructing* the namespaces during
+     * `new Demos()` — which reach into `@/abstraction`, tokens, contracts — is
+     * the part that risked tripping the websdk↔abstraction import cycle;
+     * deferring construction removes that crash vector. (2) it avoids building
+     * ~6 objects on every `new Demos()` that many callers never touch.
+     *
+     * Note: the programmatic module graph is still *loaded* when this file is
+     * imported (a static `import` cannot be deferred in ESM). That residual
+     * cycle is benign — no module reads a cross-cycle binding at evaluation
+     * time, only inside functions — and has been narrowed by importing
+     * `Identities` directly from `@/abstraction/Identities` rather than via the
+     * `@/abstraction` barrel.
+     *
+     * @example
+     * ```ts
+     * // one-call payment, auto-broadcast within the 5 DEM fee cap
+     * await demos.run.pay("0x...", 100n)
+     * // build + confirm only, broadcast yourself later
+     * const r = await demos.run.pay("0x...", 100n, { confirm: "manual" })
+     * await demos.broadcast(r.validityData)
+     * ```
+     */
+    get run() {
+        return (this._run ?? (this._run = createProgrammaticTx(this)));
+    }
 }
 Demos._instance = null;
 /**