@kynesyslabs/demosdk 4.0.12 → 4.0.13

package/build/websdk/programmatic/contracts.js

@@ -0,0 +1,81 @@
+import { DemosContracts } from "../DemosContracts.js";
+/**
+ * Smart-contract operations exposed under `demos.run.contracts`.
+ *
+ * IMPORTANT — these do NOT go through the shared fee-cap runner. Unlike the
+ * other `demos.run.*` namespaces, contract deploy/call are **RPC-native**:
+ * they execute directly over `demos.rpcCall` and return the contract's own
+ * result types (`ContractInstance`, `ContractCallResult`, gas `bigint`),
+ * never a {@link ProgrammaticTxResult}. There is no separate
+ * `confirm → broadcast` stage here, so {@link ProgrammaticTxOptions}
+ * (`maxFee`, `confirm`, `wait`) do not apply.
+ *
+ * NOTE: like `ipfs.*` and `d402.pay`, the smart-contract path is **not
+ * enabled on production nodes yet** — these methods are wired and typed but
+ * cannot be exercised end-to-end until the network turns the feature on.
+ *
+ * The namespace is a thin, uniform surface over {@link DemosContracts};
+ * instantiate-free access for callers who want everything under
+ * `demos.run.*`.
+ */
+export function createContractsNamespace(ctx) {
+    const contracts = new DemosContracts(ctx.demos);
+    return {
+        /**
+         * Deploy a smart contract from source. Requires a connected wallet.
+         *
+         * RPC-native (not fee-capped). Returns the deployed
+         * {@link ContractInstance}, not a `ProgrammaticTxResult`.
+         *
+         * @example
+         * ```ts
+         * const c = await demos.run.contracts.deploy(source, [arg1, arg2])
+         * await demos.run.contracts.call(c.address, "transfer", [to, 100])
+         * ```
+         *
+         * @param source - Contract source code.
+         * @param constructorArgs - Constructor arguments (default `[]`).
+         * @param options - Deploy options (gas, etc.).
+         */
+        deploy: (source, constructorArgs, options) => contracts.deploy(source, constructorArgs, options),
+        /**
+         * Get a handle to an already-deployed contract. Read-only; no tx.
+         *
+         * @param address - The contract address.
+         * @param abi - Optional ABI to type the instance.
+         */
+        at: (address, abi) => contracts.at(address, abi),
+        /**
+         * Call a method on an existing contract by address.
+         *
+         * RPC-native (not fee-capped). Returns the raw
+         * {@link ContractCallResult}, not a `ProgrammaticTxResult`.
+         *
+         * @param contractAddress - Target contract address.
+         * @param method - Method name to invoke.
+         * @param args - Method arguments (default `[]`).
+         * @param options - Call options (gas, etc.).
+         */
+        call: (contractAddress, method, args, options) => contracts.call(contractAddress, method, args, options),
+        /**
+         * Deploy a contract from a named template.
+         *
+         * @param templateName - Registered template name.
+         * @param params - Template parameters.
+         */
+        deployTemplate: (templateName, params) => contracts.deployTemplate(templateName, params),
+        /**
+         * Estimate gas for a contract call. Read-only; no tx.
+         *
+         * @param contractAddress - Target contract address.
+         * @param method - Method name.
+         * @param args - Method arguments (default `[]`).
+         */
+        estimateGas: (contractAddress, method, args) => contracts.estimateGas(contractAddress, method, args),
+        /** Start a batch of deploy/call operations (see {@link DemosContracts.batch}). */
+        batch: () => contracts.batch(),
+        /** List the available contract template names. */
+        getAvailableTemplates: () => contracts.getAvailableTemplates(),
+    };
+}
+//# sourceMappingURL=contracts.js.map

package/build/websdk/programmatic/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAUlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAwB;IAC7D,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAE/C,OAAO;QACH;;;;;;;;;;;;;;;WAeG;QACH,MAAM,EAAE,CACJ,MAAc,EACd,eAA2B,EAC3B,OAA+B,EACN,EAAE,CAC3B,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,eAAwB,EAAE,OAAO,CAAC;QAE/D;;;;;WAKG;QACH,EAAE,EAAE,CACA,OAAe,EACf,GAAiB,EACW,EAAE,CAAC,SAAS,CAAC,EAAE,CAAI,OAAO,EAAE,GAAG,CAAC;QAEhE;;;;;;;;;;WAUG;QACH,IAAI,EAAE,CACF,eAAuB,EACvB,MAAc,EACd,IAAgB,EAChB,OAA6B,EACC,EAAE,CAChC,SAAS,CAAC,IAAI,CAAI,eAAe,EAAE,MAAM,EAAE,IAAa,EAAE,OAAO,CAAC;QAEtE;;;;;WAKG;QACH,cAAc,EAAE,CACZ,YAAoB,EACpB,MAAgC,EACP,EAAE,CAC3B,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD;;;;;;WAMG;QACH,WAAW,EAAE,CACT,eAAuB,EACvB,MAAc,EACd,IAAgB,EACD,EAAE,CACjB,SAAS,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,IAAa,CAAC;QAEjE,kFAAkF;QAClF,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;QAE9B,kDAAkD;QAClD,qBAAqB,EAAE,GAAa,EAAE,CAClC,SAAS,CAAC,qBAAqB,EAAE;KACxC,CAAA;AACL,CAAC"}

package/build/websdk/programmatic/d402.d.ts

@@ -0,0 +1,33 @@
+import { type D402PaymentRequirement } from "../../d402/client";
+import type { ProgrammaticContext } from "./context";
+import type { ProgrammaticTxOptions, ProgrammaticTxResult } from "./types";
+/**
+ * HTTP 402 ("d402") payments as one-call programmatic transactions.
+ *
+ * Wraps {@link D402Client.createPayment}, which turns the payment
+ * requirements from a 402 response into an UNSIGNED `d402_payment`
+ * transaction. The method hands a thunk producing that transaction to
+ * `ctx.run(...)`, which signs, confirms against the fee ceiling and
+ * auto-broadcasts — keeping fee-cap policy, confirmation strategy and result
+ * shape uniform with the rest of `demos.run.*`.
+ */
+export declare function createD402Namespace(ctx: ProgrammaticContext): {
+    /**
+     * Settle an HTTP 402 payment requirement, end to end.
+     *
+     * @example
+     * ```ts
+     * const res = await fetch("/premium")
+     * if (res.status === 402) {
+     *     const requirement = await res.json()
+     *     // auto-broadcast within the 5 DEM fee cap:
+     *     await demos.run.d402.pay(requirement)
+     * }
+     * ```
+     *
+     * @param requirement - Payment requirements from the 402 response
+     *                       (amount, recipient, resourceId, description).
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    pay: (requirement: D402PaymentRequirement, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+};

package/build/websdk/programmatic/d402.js

@@ -0,0 +1,35 @@
+import { D402Client } from "../../d402/client/index.js";
+/**
+ * HTTP 402 ("d402") payments as one-call programmatic transactions.
+ *
+ * Wraps {@link D402Client.createPayment}, which turns the payment
+ * requirements from a 402 response into an UNSIGNED `d402_payment`
+ * transaction. The method hands a thunk producing that transaction to
+ * `ctx.run(...)`, which signs, confirms against the fee ceiling and
+ * auto-broadcasts — keeping fee-cap policy, confirmation strategy and result
+ * shape uniform with the rest of `demos.run.*`.
+ */
+export function createD402Namespace(ctx) {
+    const client = new D402Client(ctx.demos);
+    return {
+        /**
+         * Settle an HTTP 402 payment requirement, end to end.
+         *
+         * @example
+         * ```ts
+         * const res = await fetch("/premium")
+         * if (res.status === 402) {
+         *     const requirement = await res.json()
+         *     // auto-broadcast within the 5 DEM fee cap:
+         *     await demos.run.d402.pay(requirement)
+         * }
+         * ```
+         *
+         * @param requirement - Payment requirements from the 402 response
+         *                       (amount, recipient, resourceId, description).
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        pay: (requirement, opts) => ctx.run(() => client.createPayment(requirement), opts),
+    };
+}
+//# sourceMappingURL=d402.js.map

package/build/websdk/programmatic/d402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d402.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/d402.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA+B,MAAM,eAAe,CAAA;AAIvE;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAwB;IACxD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAExC,OAAO;QACH;;;;;;;;;;;;;;;;WAgBG;QACH,GAAG,EAAE,CACD,WAAmC,EACnC,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;KAC7D,CAAA;AACL,CAAC"}

package/build/websdk/programmatic/demoswork.d.ts

@@ -0,0 +1,37 @@
+import { type DemosWork } from "../../demoswork";
+import type { ProgrammaticContext } from "./context";
+import type { ProgrammaticTxOptions, ProgrammaticTxResult } from "./types";
+/**
+ * DemosWork scripts as one-call programmatic transactions.
+ *
+ * Assembling a {@link DemosWork} (its steps, operations and conditionals) stays
+ * with the caller. Once built, this namespace collapses the classic
+ * `prepareDemosWorkPayload → confirm → broadcast` flow into a single call that
+ * auto-broadcasts within the configured fee ceiling.
+ */
+export declare function createDemosworkNamespace(ctx: ProgrammaticContext): {
+    /**
+     * Submit an assembled {@link DemosWork} script as a `demoswork`
+     * transaction, end to end.
+     *
+     * `prepareDemosWorkPayload` serialises and signs the work; the shared
+     * runner then confirms it and (in `"auto"` mode) broadcasts it within
+     * the fee cap.
+     *
+     * @example
+     * ```ts
+     * import { DemosWork } from "@kynesyslabs/demosdk"
+     * const work = new DemosWork()
+     * // ... push steps / operations onto `work` ...
+     * // auto-broadcast within the fee cap:
+     * await demos.run.demoswork.submit(work)
+     * // build + confirm only, broadcast later yourself:
+     * const r = await demos.run.demoswork.submit(work, { confirm: "manual" })
+     * await demos.broadcast(r.validityData)
+     * ```
+     *
+     * @param work - The assembled DemosWork script to execute.
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    submit: (work: DemosWork, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+};

package/build/websdk/programmatic/demoswork.js

@@ -0,0 +1,38 @@
+import { prepareDemosWorkPayload } from "../../demoswork/index.js";
+/**
+ * DemosWork scripts as one-call programmatic transactions.
+ *
+ * Assembling a {@link DemosWork} (its steps, operations and conditionals) stays
+ * with the caller. Once built, this namespace collapses the classic
+ * `prepareDemosWorkPayload → confirm → broadcast` flow into a single call that
+ * auto-broadcasts within the configured fee ceiling.
+ */
+export function createDemosworkNamespace(ctx) {
+    return {
+        /**
+         * Submit an assembled {@link DemosWork} script as a `demoswork`
+         * transaction, end to end.
+         *
+         * `prepareDemosWorkPayload` serialises and signs the work; the shared
+         * runner then confirms it and (in `"auto"` mode) broadcasts it within
+         * the fee cap.
+         *
+         * @example
+         * ```ts
+         * import { DemosWork } from "@kynesyslabs/demosdk"
+         * const work = new DemosWork()
+         * // ... push steps / operations onto `work` ...
+         * // auto-broadcast within the fee cap:
+         * await demos.run.demoswork.submit(work)
+         * // build + confirm only, broadcast later yourself:
+         * const r = await demos.run.demoswork.submit(work, { confirm: "manual" })
+         * await demos.broadcast(r.validityData)
+         * ```
+         *
+         * @param work - The assembled DemosWork script to execute.
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        submit: (work, opts) => ctx.run(() => prepareDemosWorkPayload(work, ctx.demos), opts),
+    };
+}
+//# sourceMappingURL=demoswork.js.map

package/build/websdk/programmatic/demoswork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demoswork.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/demoswork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAIrE;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAwB;IAC7D,OAAO;QACH;;;;;;;;;;;;;;;;;;;;;;WAsBG;QACH,MAAM,EAAE,CACJ,IAAe,EACf,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;KACpE,CAAA;AACL,CAAC"}

package/build/websdk/programmatic/errors.d.ts

@@ -0,0 +1,20 @@
+import type { TxConfirmInfo } from "./types";
+/**
+ * Thrown by the programmatic-tx runner when a transaction's confirmed fee
+ * exceeds the configured ceiling (`maxFee`, default 5 DEM) and the caller
+ * did not supply a confirmation callback to override the decision.
+ *
+ * The transaction has been *built, signed and confirmed* by the time this
+ * throws — it simply was NOT broadcast. Callers can catch this, inspect
+ * `info.validityData`, and either raise `maxFee` or re-run with an explicit
+ * `confirm` callback.
+ */
+export declare class FeeCapExceededError extends Error {
+    /** Total confirmed fee, in OS (smallest unit). */
+    readonly feeOs: bigint;
+    /** Configured ceiling, in OS. */
+    readonly capOs: bigint;
+    /** The confirmation context (transaction, validityData, fee breakdown). */
+    readonly info: TxConfirmInfo;
+    constructor(feeOs: bigint, capOs: bigint, info: TxConfirmInfo);
+}

package/build/websdk/programmatic/errors.js

@@ -0,0 +1,24 @@
+import { osToDem } from "../../denomination/index.js";
+/**
+ * Thrown by the programmatic-tx runner when a transaction's confirmed fee
+ * exceeds the configured ceiling (`maxFee`, default 5 DEM) and the caller
+ * did not supply a confirmation callback to override the decision.
+ *
+ * The transaction has been *built, signed and confirmed* by the time this
+ * throws — it simply was NOT broadcast. Callers can catch this, inspect
+ * `info.validityData`, and either raise `maxFee` or re-run with an explicit
+ * `confirm` callback.
+ */
+export class FeeCapExceededError extends Error {
+    constructor(feeOs, capOs, info) {
+        super(`[programmatic-tx] fee ${osToDem(feeOs)} DEM exceeds the ` +
+            `maxFee ceiling of ${osToDem(capOs)} DEM; transaction was ` +
+            `signed and confirmed but NOT broadcast. Raise 'maxFee' or ` +
+            `pass a 'confirm' callback to override.`);
+        this.name = "FeeCapExceededError";
+        this.feeOs = feeOs;
+        this.capOs = capOs;
+        this.info = info;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/websdk/programmatic/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAGxC;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAQ1C,YAAY,KAAa,EAAE,KAAa,EAAE,IAAmB;QACzD,KAAK,CACD,yBAAyB,OAAO,CAAC,KAAK,CAAC,mBAAmB;YACtD,qBAAqB,OAAO,CAAC,KAAK,CAAC,wBAAwB;YAC3D,4DAA4D;YAC5D,wCAAwC,CAC/C,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;CACJ"}

package/build/websdk/programmatic/escrow.d.ts

@@ -0,0 +1,75 @@
+import type { ProgrammaticContext } from "./context";
+import type { ProgrammaticTxOptions, ProgrammaticTxResult } from "./types";
+/**
+ * Social-identity escrow as one-call programmatic transactions.
+ *
+ * Wraps the static {@link EscrowTransaction} builders so sending DEM to an
+ * unclaimed social identity, claiming it, or refunding an expired escrow
+ * collapses the classic `build/sign → confirm → broadcast` flow into a
+ * single call. Each builder here returns a SIGNED transaction; the method
+ * hands a thunk producing it to `ctx.run(...)`, which confirms against the
+ * fee ceiling and auto-broadcasts — keeping fee-cap policy, confirmation
+ * strategy and result shape uniform with the rest of `demos.run.*`.
+ */
+export declare function createEscrowNamespace(ctx: ProgrammaticContext): {
+    /**
+     * Send DEM to a social-identity escrow, end to end.
+     *
+     * P4 dual-input amount: `bigint` OS (preferred) or `number` DEM
+     * (legacy, auto-converted). Sub-DEM precision against a pre-fork
+     * node throws.
+     *
+     * @example
+     * ```ts
+     * import { denomination } from "@kynesyslabs/demosdk"
+     * // auto-broadcast within the 5 DEM fee cap:
+     * await demos.run.escrow.send(
+     *     "twitter", "@bob", denomination.demToOs(100),
+     *     { expiryDays: 30, message: "Welcome to Demos!" },
+     * )
+     * // build + confirm only, broadcast later yourself:
+     * const r = await demos.run.escrow.send(
+     *     "twitter", "@bob", 100n, undefined, { confirm: "manual" },
+     * )
+     * await demos.broadcast(r.validityData)
+     * ```
+     *
+     * @param platform - Social platform ("twitter", "github", "telegram").
+     * @param username - Username on that platform (e.g., "@bob").
+     * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
+     * @param options - Optional escrow parameters (expiry, memo).
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    send: (platform: "twitter" | "github" | "telegram", username: string, amount: number | bigint, options?: {
+        expiryDays?: number;
+        message?: string;
+    }, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+    /**
+     * Claim escrowed funds for a social identity you have linked, end to
+     * end.
+     *
+     * @example
+     * ```ts
+     * await demos.run.escrow.claim("twitter", "@bob")
+     * ```
+     *
+     * @param platform - Social platform ("twitter", "github", "telegram").
+     * @param username - Username to claim for.
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    claim: (platform: "twitter" | "github" | "telegram", username: string, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+    /**
+     * Refund an expired escrow back to the original depositor, end to
+     * end.
+     *
+     * @example
+     * ```ts
+     * await demos.run.escrow.refund("twitter", "@unclaimed_user")
+     * ```
+     *
+     * @param platform - Social platform ("twitter", "github", "telegram").
+     * @param username - Username whose expired escrow to refund.
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    refund: (platform: "twitter" | "github" | "telegram", username: string, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+};

package/build/websdk/programmatic/escrow.js

@@ -0,0 +1,74 @@
+import { EscrowTransaction } from "../../escrow/index.js";
+/**
+ * Social-identity escrow as one-call programmatic transactions.
+ *
+ * Wraps the static {@link EscrowTransaction} builders so sending DEM to an
+ * unclaimed social identity, claiming it, or refunding an expired escrow
+ * collapses the classic `build/sign → confirm → broadcast` flow into a
+ * single call. Each builder here returns a SIGNED transaction; the method
+ * hands a thunk producing it to `ctx.run(...)`, which confirms against the
+ * fee ceiling and auto-broadcasts — keeping fee-cap policy, confirmation
+ * strategy and result shape uniform with the rest of `demos.run.*`.
+ */
+export function createEscrowNamespace(ctx) {
+    return {
+        /**
+         * Send DEM to a social-identity escrow, end to end.
+         *
+         * P4 dual-input amount: `bigint` OS (preferred) or `number` DEM
+         * (legacy, auto-converted). Sub-DEM precision against a pre-fork
+         * node throws.
+         *
+         * @example
+         * ```ts
+         * import { denomination } from "@kynesyslabs/demosdk"
+         * // auto-broadcast within the 5 DEM fee cap:
+         * await demos.run.escrow.send(
+         *     "twitter", "@bob", denomination.demToOs(100),
+         *     { expiryDays: 30, message: "Welcome to Demos!" },
+         * )
+         * // build + confirm only, broadcast later yourself:
+         * const r = await demos.run.escrow.send(
+         *     "twitter", "@bob", 100n, undefined, { confirm: "manual" },
+         * )
+         * await demos.broadcast(r.validityData)
+         * ```
+         *
+         * @param platform - Social platform ("twitter", "github", "telegram").
+         * @param username - Username on that platform (e.g., "@bob").
+         * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
+         * @param options - Optional escrow parameters (expiry, memo).
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        send: (platform, username, amount, options, opts) => ctx.run(() => EscrowTransaction.sendToIdentity(ctx.demos, platform, username, amount, options), opts),
+        /**
+         * Claim escrowed funds for a social identity you have linked, end to
+         * end.
+         *
+         * @example
+         * ```ts
+         * await demos.run.escrow.claim("twitter", "@bob")
+         * ```
+         *
+         * @param platform - Social platform ("twitter", "github", "telegram").
+         * @param username - Username to claim for.
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        claim: (platform, username, opts) => ctx.run(() => EscrowTransaction.claimEscrow(ctx.demos, platform, username), opts),
+        /**
+         * Refund an expired escrow back to the original depositor, end to
+         * end.
+         *
+         * @example
+         * ```ts
+         * await demos.run.escrow.refund("twitter", "@unclaimed_user")
+         * ```
+         *
+         * @param platform - Social platform ("twitter", "github", "telegram").
+         * @param username - Username whose expired escrow to refund.
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        refund: (platform, username, opts) => ctx.run(() => EscrowTransaction.refundExpiredEscrow(ctx.demos, platform, username), opts),
+    };
+}
+//# sourceMappingURL=escrow.js.map

package/build/websdk/programmatic/escrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/escrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAI5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAwB;IAC1D,OAAO;QACH;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2BG;QACH,IAAI,EAAE,CACF,QAA2C,EAC3C,QAAgB,EAChB,MAAuB,EACvB,OAGC,EACD,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CACH,GAAG,EAAE,CACD,iBAAiB,CAAC,cAAc,CAC5B,GAAG,CAAC,KAAK,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,CACV,EACL,IAAI,CACP;QAEL;;;;;;;;;;;;WAYG;QACH,KAAK,EAAE,CACH,QAA2C,EAC3C,QAAgB,EAChB,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CACH,GAAG,EAAE,CACD,iBAAiB,CAAC,WAAW,CACzB,GAAG,CAAC,KAAK,EACT,QAAQ,EACR,QAAQ,CACX,EACL,IAAI,CACP;QAEL;;;;;;;;;;;;WAYG;QACH,MAAM,EAAE,CACJ,QAA2C,EAC3C,QAAgB,EAChB,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CACH,GAAG,EAAE,CACD,iBAAiB,CAAC,mBAAmB,CACjC,GAAG,CAAC,KAAK,EACT,QAAQ,EACR,QAAQ,CACX,EACL,IAAI,CACP;KACR,CAAA;AACL,CAAC"}

package/build/websdk/programmatic/governance.d.ts

@@ -0,0 +1,59 @@
+import type { NetworkParameters } from "../../types/blockchain/NetworkParameters";
+import type { ProgrammaticContext } from "./context";
+import type { ProgrammaticTxOptions, ProgrammaticTxResult } from "./types";
+/**
+ * Parameters for a network-upgrade proposal.
+ *
+ * Mirrors the object accepted by `DemosTransactions.proposeNetworkUpgrade`.
+ */
+export interface ProposeNetworkUpgradeParams {
+    /** UUID. Also used as lexicographic activation-order tiebreaker. */
+    proposalId: string;
+    /** Subset of {@link NetworkParameters} to change. */
+    proposedParameters: Partial<NetworkParameters>;
+    /** Human-readable reason, ≤1024 bytes. */
+    rationale: string;
+    /** Activation block. Must be ≥ tallyBlock + grace period. */
+    effectiveAtBlock: number;
+}
+/**
+ * On-chain governance (network upgrades) as one-call programmatic transactions.
+ *
+ * Collapses the classic `build → confirm → broadcast` flow for proposing and
+ * voting on network upgrades into a single call that auto-broadcasts within
+ * the configured fee ceiling.
+ */
+export declare function createGovernanceNamespace(ctx: ProgrammaticContext): {
+    /**
+     * Submit a network-upgrade proposal, end to end.
+     *
+     * @example
+     * ```ts
+     * await demos.run.governance.propose({
+     *     proposalId: crypto.randomUUID(),
+     *     proposedParameters: { blockTimeMs: 5000 },
+     *     rationale: "Reduce block time for lower latency.",
+     *     effectiveAtBlock: 1_000_000,
+     * })
+     * ```
+     *
+     * @param params - Proposal fields (id, parameters, rationale, activation block).
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    propose: (params: ProposeNetworkUpgradeParams, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+    /**
+     * Cast a vote on a pending network-upgrade proposal, end to end. The
+     * vote is final and non-revocable.
+     *
+     * @example
+     * ```ts
+     * await demos.run.governance.vote(proposalId, true) // yes
+     * await demos.run.governance.vote(proposalId, false) // no
+     * ```
+     *
+     * @param proposalId - The proposal to vote on.
+     * @param approve - `true` to approve, `false` to reject.
+     * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+     */
+    vote: (proposalId: string, approve: boolean, opts?: ProgrammaticTxOptions) => Promise<ProgrammaticTxResult>;
+};

package/build/websdk/programmatic/governance.js

@@ -0,0 +1,44 @@
+/**
+ * On-chain governance (network upgrades) as one-call programmatic transactions.
+ *
+ * Collapses the classic `build → confirm → broadcast` flow for proposing and
+ * voting on network upgrades into a single call that auto-broadcasts within
+ * the configured fee ceiling.
+ */
+export function createGovernanceNamespace(ctx) {
+    return {
+        /**
+         * Submit a network-upgrade proposal, end to end.
+         *
+         * @example
+         * ```ts
+         * await demos.run.governance.propose({
+         *     proposalId: crypto.randomUUID(),
+         *     proposedParameters: { blockTimeMs: 5000 },
+         *     rationale: "Reduce block time for lower latency.",
+         *     effectiveAtBlock: 1_000_000,
+         * })
+         * ```
+         *
+         * @param params - Proposal fields (id, parameters, rationale, activation block).
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        propose: (params, opts) => ctx.run(() => ctx.demos.tx.proposeNetworkUpgrade(params, ctx.demos), opts),
+        /**
+         * Cast a vote on a pending network-upgrade proposal, end to end. The
+         * vote is final and non-revocable.
+         *
+         * @example
+         * ```ts
+         * await demos.run.governance.vote(proposalId, true) // yes
+         * await demos.run.governance.vote(proposalId, false) // no
+         * ```
+         *
+         * @param proposalId - The proposal to vote on.
+         * @param approve - `true` to approve, `false` to reject.
+         * @param opts - Fee ceiling / confirmation strategy / wait behaviour.
+         */
+        vote: (proposalId, approve, opts) => ctx.run(() => ctx.demos.tx.voteOnUpgrade(proposalId, approve, ctx.demos), opts),
+    };
+}
+//# sourceMappingURL=governance.js.map

package/build/websdk/programmatic/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/governance.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAwB;IAC9D,OAAO;QACH;;;;;;;;;;;;;;;WAeG;QACH,OAAO,EAAE,CACL,MAAmC,EACnC,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CACH,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,EAC3D,IAAI,CACP;QAEL;;;;;;;;;;;;;WAaG;QACH,IAAI,EAAE,CACF,UAAkB,EAClB,OAAgB,EAChB,IAA4B,EACC,EAAE,CAC/B,GAAG,CAAC,GAAG,CACH,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAChE,IAAI,CACP;KACR,CAAA;AACL,CAAC"}

package/build/websdk/programmatic/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Programmatic transaction system.
+ *
+ * A single one-call method per transaction type that fills parameters from
+ * arguments and routes through one shared runner (`build → sign → confirm →
+ * broadcast`). Auto-broadcasts within a configurable fee ceiling (default
+ * 5 DEM); supports a `"manual"` confirm mode that returns the validity data
+ * unbroadcast (the classic flow), and a callback mode for custom
+ * confirmation.
+ *
+ * Reached via `demos.run.*` on a connected {@link Demos} instance.
+ */
+export * from "./types";
+export * from "./errors";
+export * from "./runner";
+export * from "./context";
+export * from "./pay";
+export * from "./attest";
+export * from "./tokens";
+export * from "./storage";
+export * from "./escrow";
+export * from "./validator";
+export * from "./governance";
+export * from "./xm";
+export * from "./bridge";
+export * from "./demoswork";
+export * from "./ipfs";
+export * from "./d402";
+export * from "./contracts";
+export * from "./ProgrammaticTx";

package/build/websdk/programmatic/index.js

@@ -0,0 +1,31 @@
+/**
+ * Programmatic transaction system.
+ *
+ * A single one-call method per transaction type that fills parameters from
+ * arguments and routes through one shared runner (`build → sign → confirm →
+ * broadcast`). Auto-broadcasts within a configurable fee ceiling (default
+ * 5 DEM); supports a `"manual"` confirm mode that returns the validity data
+ * unbroadcast (the classic flow), and a callback mode for custom
+ * confirmation.
+ *
+ * Reached via `demos.run.*` on a connected {@link Demos} instance.
+ */
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./runner.js";
+export * from "./context.js";
+export * from "./pay.js";
+export * from "./attest.js";
+export * from "./tokens.js";
+export * from "./storage.js";
+export * from "./escrow.js";
+export * from "./validator.js";
+export * from "./governance.js";
+export * from "./xm.js";
+export * from "./bridge.js";
+export * from "./demoswork.js";
+export * from "./ipfs.js";
+export * from "./d402.js";
+export * from "./contracts.js";
+export * from "./ProgrammaticTx.js";
+//# sourceMappingURL=index.js.map

package/build/websdk/programmatic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/websdk/programmatic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,MAAM,CAAA;AACpB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}