@ouronet/ouronet-core 4.3.6

package/dist/interactions/ouroPrimordialsFunctions.js

@@ -0,0 +1,480 @@
+/**
+ * ouroPrimordialsFunctions.ts
+ * Chain call to ouronet-ns.DPL-UR.URC_0002_Primordials plus the placeholder factory.
+ * The internal `parseResponse` and `fmt` helpers retain the v4.x token-decoration
+ * logic verbatim for backward compat (v5.0.0 will physically extract it).
+ */
+import { KADENA_NAMESPACE } from "../constants/index.js";
+import { formatEU, mayComeWithDeimal } from "@stoachain/stoa-core/pact";
+import { pactRead } from "@stoachain/stoa-core/reads";
+// (namespace.DPL-UR.URC_0002_Primordials account)
+export async function getPrimordials(currentAccount = "", codexAccounts = [], options) {
+    const accountsList = codexAccounts.map((a) => `"${a}"`).join(" ");
+    const pactCode = `(${KADENA_NAMESPACE}.DPL-UR.URC_0002_Primordials "${currentAccount}" [${accountsList}])`;
+    const response = await pactRead(pactCode, { tier: "T5", skipTempWatcher: options?.skipTempWatcher });
+    if (!response || !response.result) {
+        return null; // network failure — caller should retry, not show ???
+    }
+    if (response.result.status === "failure") {
+        return null; // pact failure — caller should retry, not show ???
+    }
+    return parseResponse(response.result.data);
+}
+const fmt = (v) => formatEU(mayComeWithDeimal(v) ?? null);
+const parseResponse = (data) => {
+    const d = data[0];
+    const codex = data[1] ?? {};
+    const supplyHoverVal = (v) => {
+        const raw = mayComeWithDeimal(v);
+        return formatEU(raw !== null && raw !== undefined ? String(raw) : null);
+    };
+    const ouro = {
+        id: d["ouro-id"],
+        name: d["ouro-name"],
+        icon: "/images/coins/OURO.svg",
+        iconBgColor: "bg-primary/5",
+        balance: {
+            display: fmt(d["ouro-balance"]),
+            value: fmt(d["ouro-balance-hover"]),
+        },
+        balanceUsd: fmt(d["ouro-balance-vid"]),
+        pricePerUnit: fmt(d["ouro-price"]),
+        totalSupply: {
+            display: fmt(d["ouro-dispo-capacity"]),
+            value: fmt(d["ouro-dispo-capacity-hover"]),
+        },
+        supplyUsdValue: fmt(d["ouro-dispo-capacity-vid"]),
+        virtual: {
+            display: fmt(d["ouro-v-balance"]),
+            value: fmt(d["ouro-v-balance-hover"]),
+            inUsd: fmt(d["ouro-v-balance-vid"]),
+        },
+        info: "",
+        currencySymbol: "Ѻ",
+        currencySymbolColor: "#7b4a1e",
+        availableActions: ["Sublimate", "Coil", "Curl", "Transfer", "Bulk Transfer"],
+        keepTransferNames: true,
+        balanceLabel: "Balance",
+        virtualLabel: "Virtual Balance",
+        supplyLabel: "Dispo Capacity",
+    };
+    const ignis = {
+        id: d["gas-id"],
+        name: d["gas-name"],
+        icon: "/images/coins/Ignis.svg",
+        iconBgColor: "bg-primary/5",
+        balance: {
+            display: fmt(d["gas-balance"]),
+            value: fmt(d["gas-balance-hover"]),
+        },
+        balanceUsd: fmt(d["gas-balance-vid"]),
+        pricePerUnit: fmt(d["gas-price"]),
+        totalSupply: {
+            display: fmt(d["gas-supply"]),
+            value: supplyHoverVal(d["gas-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["gas-supply-vid"]),
+        virtual: null,
+        info: d["gas-discount-text"] ?? "",
+        currencySymbol: "Ω",
+        currencySymbolColor: "#cc2200",
+        availableActions: ["Compress", "Firestarter", "Transfer", "Bulk Transfer"],
+        keepTransferNames: true,
+        maxButtonsPerRow: 2,
+        balanceLabel: "Balance",
+        showCodexRow: true,
+        supplyLabel: "Ouronet Total GAS",
+        codexBalance: {
+            display: fmt(codex["codex-balance"]),
+            value: fmt(codex["codex-balance-hover"]),
+            inUsd: fmt(codex["codex-balance-vid"]),
+        },
+    };
+    const auryn = {
+        id: d["auryn-id"],
+        name: d["auryn-name"],
+        icon: "/images/coins/AURYN.svg",
+        iconBgColor: "bg-purple-50",
+        balance: {
+            display: fmt(d["auryn-balance"]),
+            value: fmt(d["auryn-balance-hover"]),
+        },
+        balanceUsd: fmt(d["auryn-balance-vid"]),
+        pricePerUnit: fmt(d["auryn-price"]),
+        totalSupply: {
+            display: fmt(d["auryn-supply"]),
+            value: fmt(d["auryn-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["auryn-supply-vid"]),
+        supplyLabel: "Auryn Supply",
+        postSupplyRow: {
+            label: "Ouroboros Supply",
+            value: fmt(d["ouro-supply"]),
+            hoverValue: fmt(d["ouro-supply-hover"]),
+            usdValue: fmt(d["ouro-supply-vid"]),
+            suffix: " Ѻ",
+            suffixColor: "#7b4a1e",
+        },
+        virtual: null,
+        info: "",
+        currencySymbol: "₳",
+        currencySymbolColor: "#d2d3d4",
+        availableActions: ["Autostake (Coil)", "Recover (Uncoil)", "Transfer", "Bulk Transfer"],
+        keepTransferNames: true,
+        maxButtonsPerRow: 2,
+        hideSupplySeparator: true,
+    };
+    const eauryn = {
+        id: d["eauryn-id"],
+        name: d["eauryn-name"],
+        icon: "/images/coins/ELITE-AURYN.svg",
+        iconBgColor: "bg-yellow-50",
+        balance: {
+            display: fmt(d["eauryn-balance"]),
+            value: fmt(d["eauryn-balance-hover"]),
+        },
+        balanceUsd: fmt(d["eauryn-balance-vid"]),
+        pricePerUnit: fmt(d["eauryn-price"]),
+        totalSupply: {
+            display: fmt(d["eauryn-supply"]),
+            value: fmt(d["eauryn-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["eauryn-supply-vid"]),
+        supplyLabel: "EliteAuryn Supply",
+        virtual: null,
+        info: "",
+        currencySymbol: "Ξ₳",
+        currencySymbolColor: "#ceac5f",
+        availableActions: ["Clear Ouroboros Dispo", "Recover (Uncoil)", "Transfer", "Bulk Transfer"],
+        keepTransferNames: true,
+        notImplementedActions: [],
+        maxButtonsPerRow: 2,
+        hideSupplySeparator: true,
+        extraBalanceRow: {
+            label: "EA to Next Tier",
+            value: fmt(d["eauryn-next"]),
+            hoverValue: fmt(d["eauryn-next-hover"]),
+            usdValue: fmt(d["eauryn-next-vid"]),
+        },
+    };
+    const wstoa = {
+        id: d["wstoa-id"],
+        name: "WSTOA",
+        icon: "/images/coins/WSTOA.svg",
+        iconBgColor: "bg-primary/5",
+        balance: {
+            display: fmt(d["wstoa-wrapped-balance"]),
+            value: fmt(d["wstoa-wrapped-balance-hover"]),
+        },
+        balanceUsd: fmt(d["wstoa-wrapped-balance-vid"]),
+        pricePerUnit: fmt(d["wstoa-price"]),
+        totalSupply: {
+            display: fmt(d["wstoa-wrapped-total-supply"]),
+            value: fmt(d["wstoa-wrapped-total-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["wstoa-wrapped-total-supply-vid"]),
+        virtual: null,
+        info: d["stoa-discount-text"] ?? "",
+        currencySymbol: "❖",
+        currencySymbolColor: "#ceac5f",
+        displayName: "WrappedStoa",
+        leadingBalanceRow: {
+            label: "Native Balance",
+            value: fmt(d["wstoa-native-balance"]),
+            hoverValue: supplyHoverVal(d["wstoa-native-balance-hover"]),
+            usdValue: fmt(d["wstoa-native-balance-vid"]),
+            suffix: " ❖",
+            suffixColor: "#ceac5f",
+        },
+        balanceLabel: "Wrapped Balance",
+        supplyLabel: "Total Wrapped Supply",
+        hideSupplySeparator: true,
+        keepTransferNames: true,
+        availableActions: ["Coil", "Brumate", "Wrap", "Transfer", "Bulk Transfer", "Unwrap"],
+    };
+    const sstoa = {
+        id: d["sstoa-id"],
+        name: "SSTOA",
+        icon: "/images/coins/SSTOA.svg",
+        iconBgColor: "bg-primary/5",
+        balance: {
+            display: fmt(d["sstoa-balance"]),
+            value: fmt(d["sstoa-balance-hover"]),
+        },
+        balanceUsd: fmt(d["sstoa-balance-vid"]),
+        pricePerUnit: fmt(d["sstoa-price"]),
+        totalSupply: {
+            display: fmt(d["sstoa-supply"]),
+            value: fmt(d["sstoa-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["sstoa-supply-vid"]),
+        virtual: null,
+        info: "",
+        currencySymbol: "◈",
+        currencySymbolColor: "#e8e8e8",
+        displayName: "SilverStoa",
+        supplyLabel: "Total SilverStoa Supply",
+        hideSupplySeparator: true,
+        keepTransferNames: true,
+        maxButtonsPerRow: 2,
+        availableActions: ["Constrict", "Recover", "Transfer", "Bulk Transfer"],
+        postSupplyRow: {
+            label: "Total GoldenStoa Supply",
+            value: fmt(d["gstoa-supply"]),
+            hoverValue: fmt(d["gstoa-supply-hover"]),
+            usdValue: fmt(d["gstoa-supply-vid"]),
+            suffix: " ◈",
+            suffixColor: "#ceac5f",
+        },
+    };
+    const gstoa = {
+        id: d["gstoa-id"],
+        displayId: `${d["gstoa-id"] ?? "GSTOA"} | ${d["hgstoa-id"] ?? "H|GSTOA"}`,
+        name: "GSTOA",
+        icon: "/images/coins/SSTOA.svg",
+        isGoldIcon: true,
+        balance: {
+            display: fmt(d["gstoa-balance"]),
+            value: fmt(d["gstoa-balance-hover"]),
+        },
+        balanceUsd: fmt(d["gstoa-balance-vid"]),
+        pricePerUnit: fmt(d["gstoa-price"]),
+        totalSupply: {
+            display: fmt(d["gstoa-supply"]),
+            value: fmt(d["gstoa-supply-hover"]),
+        },
+        supplyUsdValue: fmt(d["gstoa-supply-vid"]),
+        virtual: null,
+        info: "",
+        currencySymbol: "◈",
+        currencySymbolColor: "#ceac5f",
+        displayName: "GoldenStoa",
+        hideSupplySeparator: true,
+        hideSupplyRow: true,
+        middleBalanceRows: [
+            {
+                label: "Hibernated Balance (Nonces)",
+                value: fmt(d["hgstoa-balance-nonces"]),
+                hoverValue: d["hgstoa-balance-nonces-hover"] ?? undefined,
+                usdValue: fmt(d["hgstoa-balance-nonces-vid"]),
+                suffix: " ◈",
+                suffixColor: "#ceac5f",
+            },
+            {
+                label: "Total GoldenStoa",
+                value: fmt(d["gstoa-total-balance"]),
+                hoverValue: fmt(d["gstoa-total-balance-hover"]),
+                usdValue: fmt(d["gstoa-total-balance-vid"]),
+                suffix: " ◈",
+                suffixColor: "#ceac5f",
+            },
+        ],
+        availableActions: ["Recover", "Transfer", "Bulk Transfer", "Awake", "Slumber", "Transfer Nonces"],
+        keepTransferNames: true,
+        notImplementedActions: [],
+    };
+    const urstoa = {
+        id: "URSTOA",
+        displayId: "coin.UR|StoaTable",
+        name: "UrStoa",
+        icon: "/images/coins/WSTOA.svg",
+        isStoneIcon: true,
+        pricePerUnit: "—",
+        balanceUsd: "—",
+        balance: { display: "—", value: "0" },
+        totalSupply: { display: "—", value: "0" },
+        currencySymbol: "✦",
+        currencySymbolColor: "#555555",
+        hidePrice: true,
+        hideSupplySeparator: true,
+        textAlignTop: true,
+        customBalanceRows: [
+            {
+                label: "Wrapped Balance",
+                value: fmt(String(d["urstoa-wrapped-balance"] ?? 0)),
+                suffix: " ✦",
+                suffixColor: "#555555",
+            },
+            {
+                label: "Payment Key Balance",
+                value: fmt(String(d["urstoa-payment-key-balance"] ?? 0)),
+                suffix: " ✦",
+                suffixColor: "#555555",
+            },
+            {
+                label: "UrStoa Vault Balance",
+                value: fmt(String(d["urstoa-vault-balance"] ?? 0)),
+                suffix: " ✦",
+                suffixColor: "#555555",
+            },
+            {
+                label: "UrStoa Vault Earnings in STOA",
+                value: fmt(d["urstoa-vault-earnings"]),
+                // The chain returns this hover as a { decimal: "…" } object (like the
+                // supply hover). Route it through supplyHoverVal so mayComeWithDeimal
+                // unwraps it — `String({decimal})` would yield "[object Object]", which
+                // parses back to 0 and wrongly disables the Collect button. See supply row.
+                hoverValue: supplyHoverVal(d["urstoa-vault-earning-hover"]),
+                suffix: " ❖",
+                suffixColor: "#ceac5f",
+            },
+            {
+                label: "UrStoa Vault STOA Supply",
+                value: fmt(d["urstoa-vault-stoa-supply"]),
+                hoverValue: supplyHoverVal(d["urstoa-vault-stoa-supply-hover"]),
+                suffix: " ❖",
+                suffixColor: "#ceac5f",
+            },
+        ],
+        availableActions: ["Stake", "Unstake", "Wrap", "Collect", "Transfer", "Unwrap"],
+        keepTransferNames: true,
+        forceGoldActions: ["Transfer", "Stake", "Unstake", "Collect"],
+        notImplementedActions: [],
+        /** Wrapped UrStoa DPTF token ID (from primordials) */
+        wrappedTokenId: d["urstoa-wrapped-id"] ?? null,
+    };
+    return {
+        totalWithVirtual: formatEU(d["total-value-with-vouro"]),
+        total: formatEU(d["total-value"]),
+        tokens: [ouro, ignis, auryn, eauryn, wstoa, sstoa, gstoa, urstoa],
+    };
+};
+export function buildPlaceholderPrimordials() {
+    const Q = "???";
+    const mkToken = (name, extra = {}) => ({
+        id: Q,
+        name,
+        balance: { display: Q, value: Q },
+        balanceUsd: Q,
+        pricePerUnit: Q,
+        totalSupply: { display: Q, value: Q },
+        supplyUsdValue: Q,
+        virtual: null,
+        info: "",
+        currencySymbol: "",
+        availableActions: [],
+        ...extra,
+    });
+    return {
+        totalWithVirtual: Q,
+        total: Q,
+        tokens: [
+            mkToken("Ouroboros", {
+                icon: "/images/coins/OURO.svg",
+                currencySymbol: "Ѻ",
+                currencySymbolColor: "#7b4a1e",
+                virtual: { display: Q, value: Q, inUsd: Q },
+                availableActions: ["Sublimate", "Coil", "Curl", "Transfer", "Bulk Transfer"],
+                keepTransferNames: true,
+                balanceLabel: "Balance",
+                virtualLabel: "Virtual Balance",
+                supplyLabel: "Dispo Capacity",
+            }),
+            mkToken("Ignis", {
+                icon: "/images/coins/Ignis.svg",
+                currencySymbol: "Ω",
+                currencySymbolColor: "#cc2200",
+                showCodexRow: true,
+                codexBalance: { display: Q, value: Q, inUsd: Q },
+                availableActions: ["Compress", "Firestarter", "Transfer", "Bulk Transfer"],
+                keepTransferNames: true,
+                maxButtonsPerRow: 2,
+                supplyLabel: "Ouronet Total GAS",
+            }),
+            mkToken("Auryn", {
+                icon: "/images/coins/AURYN.svg",
+                currencySymbol: "₳",
+                hideSupplySeparator: true,
+                availableActions: ["Autostake (Coil)", "Recover (Uncoil)", "Transfer", "Bulk Transfer"],
+                keepTransferNames: true,
+                maxButtonsPerRow: 2,
+            }),
+            mkToken("EliteAuryn", {
+                icon: "/images/coins/ELITE-AURYN.svg",
+                currencySymbol: "Ξ₳",
+                currencySymbolColor: "#ceac5f",
+                hideSupplySeparator: true,
+                hideSupplyRow: true,
+                extraBalanceRow: { label: "EA to Next Tier", value: Q, usdValue: Q },
+                availableActions: ["Clear Ouroboros Dispo", "Recover (Uncoil)", "Transfer", "Bulk Transfer"],
+                keepTransferNames: true,
+                notImplementedActions: [],
+                maxButtonsPerRow: 2,
+            }),
+            mkToken("WSTOA", {
+                icon: "/images/coins/WSTOA.svg",
+                currencySymbol: "❖",
+                currencySymbolColor: "#ceac5f",
+                displayName: "WrappedStoa",
+                leadingBalanceRow: { label: "Native Balance", value: Q, usdValue: Q },
+                balanceLabel: "Wrapped Balance",
+                supplyLabel: "Total Wrapped Supply",
+                hideSupplySeparator: true,
+                keepTransferNames: true,
+                availableActions: ["Coil", "Brumate", "Wrap", "Transfer", "Bulk Transfer", "Unwrap"],
+            }),
+            mkToken("SSTOA", {
+                icon: "/images/coins/SSTOA.svg",
+                currencySymbol: "◈",
+                currencySymbolColor: "#e8e8e8",
+                displayName: "SilverStoa",
+                supplyLabel: "Total SilverStoa Supply",
+                hideSupplySeparator: true,
+                keepTransferNames: true,
+                maxButtonsPerRow: 2,
+                availableActions: ["Constrict", "Recover", "Transfer", "Bulk Transfer"],
+            }),
+            {
+                id: Q,
+                displayId: `${Q} | ${Q}`,
+                name: "GSTOA",
+                icon: "/images/coins/SSTOA.svg",
+                isGoldIcon: true,
+                balance: { display: Q, value: Q },
+                balanceUsd: Q,
+                pricePerUnit: Q,
+                totalSupply: { display: Q, value: Q },
+                supplyUsdValue: Q,
+                virtual: null,
+                info: "",
+                currencySymbol: "◈",
+                currencySymbolColor: "#ceac5f",
+                displayName: "GoldenStoa",
+                hideSupplySeparator: true,
+                hideSupplyRow: true,
+                middleBalanceRows: [
+                    { label: "Hibernated Balance (Nonces)", value: Q, usdValue: Q },
+                    { label: "Total GoldenStoa", value: Q, usdValue: Q },
+                ],
+                availableActions: ["Recover", "Transfer", "Bulk Transfer", "Awake", "Slumber", "Transfer Nonces"],
+                keepTransferNames: true,
+                notImplementedActions: [],
+            },
+            {
+                id: "URSTOA",
+                displayId: "coin.UR|StoaTable",
+                name: "UrStoa",
+                icon: "/images/coins/WSTOA.svg",
+                isStoneIcon: true,
+                pricePerUnit: "—",
+                balanceUsd: "—",
+                balance: { display: "—", value: "0" },
+                totalSupply: { display: "—", value: "0" },
+                currencySymbol: "✦",
+                currencySymbolColor: "#555555",
+                hidePrice: true,
+                hideSupplySeparator: true,
+                textAlignTop: true,
+                customBalanceRows: [
+                    { label: "Payment Key Balance", value: Q },
+                    { label: "UrStoa Vault Balance", value: Q },
+                    { label: "UrStoa Vault Earnings in STOA", value: Q },
+                    { label: "UrStoa Vault STOA Supply", value: Q },
+                ],
+                availableActions: ["Stake", "Unstake", "Collect", "Transfer"],
+                keepTransferNames: true,
+                notImplementedActions: ["Transfer"],
+            },
+        ],
+    };
+}

package/dist/interactions/ouroRotateFunctions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ouroRotateFunctions.ts
+ * Kadena payment-key rotation for Ouronet accounts (multi-signer flow).
+ */
+import type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+import type { IKeyset } from "@stoachain/stoa-core/guard";
+/**
+ * Query RotateKadena info object from the chain.
+ * (ouronet-ns.INFO-ZERO.DALOS-INFO|URC_RotateKadena <patron> <account>)
+ */
+export declare function getRotateKadenaInfo(patron: string, account: string): Promise<any | null>;
+/**
+ * Rotate Payment Key (Kadena Ledger) for an Ouronet account.
+ * (ouronet-ns.TS01-C1.DALOS|C_RotateKadena patron account newPaymentKey)
+ *
+ * Requires two signers:
+ * 1. patronKadenaKey — key from patron's guard (pays IGNIS, has GAS_PAYER cap)
+ * 2. accountGuardKey — key from the target account's guard (ownership proof)
+ *
+ * If patron == account, these may be the same key, requiring only 1 signer.
+ */
+export declare function rotateKadenaPaymentKey(patronAddress: string, accountAddress: string, newPaymentKey: string, gasStationKey: IKadenaKeypair, patronGuardKeys: IKadenaKeypair[], accountGuardKeys: IKadenaKeypair[], patronGuard: IKeyset | null, accountGuard: IKeyset | null): Promise<import("@stoachain/kadena-stoic-legacy/client").ITransactionDescriptor>;

package/dist/interactions/ouroRotateFunctions.js

@@ -0,0 +1,114 @@
+/**
+ * ouroRotateFunctions.ts
+ * Kadena payment-key rotation for Ouronet accounts (multi-signer flow).
+ */
+import { calculateAutoGasLimit } from "@stoachain/stoa-core/gas";
+import { KADENA_CHAIN_ID, KADENA_NAMESPACE, STOA_AUTONOMIC_OURONETGASSTATION, KADENA_NETWORK, } from "../constants/index.js";
+import { safeCreationTime } from "@stoachain/stoa-core/pact";
+import { Pact } from "@stoachain/kadena-stoic-legacy/client";
+import { getFailoverClient } from "@stoachain/stoa-core/network";
+import { universalSignTransaction, fromKeypair } from "@stoachain/stoa-core/signing";
+import { createSimulationError, logDetailedError } from "@stoachain/stoa-core/errors";
+import { pactRead } from "@stoachain/stoa-core/reads";
+import { getLogger } from "@stoachain/stoa-core/observability";
+/**
+ * Query RotateKadena info object from the chain.
+ * (ouronet-ns.INFO-ZERO.DALOS-INFO|URC_RotateKadena <patron> <account>)
+ */
+export async function getRotateKadenaInfo(patron, account) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ZERO.DALOS-INFO|URC_RotateKadena "${patron}" "${account}")`;
+        const response = await pactRead(pactCode, { tier: "T3" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting RotateKadena info:", error);
+        return null;
+    }
+}
+/**
+ * Rotate Payment Key (Kadena Ledger) for an Ouronet account.
+ * (ouronet-ns.TS01-C1.DALOS|C_RotateKadena patron account newPaymentKey)
+ *
+ * Requires two signers:
+ * 1. patronKadenaKey — key from patron's guard (pays IGNIS, has GAS_PAYER cap)
+ * 2. accountGuardKey — key from the target account's guard (ownership proof)
+ *
+ * If patron == account, these may be the same key, requiring only 1 signer.
+ */
+export async function rotateKadenaPaymentKey(patronAddress, accountAddress, newPaymentKey, gasStationKey, patronGuardKeys, accountGuardKeys, patronGuard, accountGuard) {
+    let gasLimit = 2000000;
+    // Collect all unique signers: gasStation + patronGuard + accountGuard
+    const allSigners = [gasStationKey];
+    const addedPubs = new Set([gasStationKey.publicKey]);
+    for (const k of [...patronGuardKeys, ...accountGuardKeys]) {
+        if (!addedPubs.has(k.publicKey)) {
+            allSigners.push(k);
+            addedPubs.add(k.publicKey);
+        }
+    }
+    const buildTransaction = (gasLimitOverride) => {
+        let builder = Pact.builder
+            .execution(`(${KADENA_NAMESPACE}.TS01-C1.DALOS|C_RotateKadena "${patronAddress}" "${accountAddress}" "${newPaymentKey}")`);
+        // Add keyset data for patron guard
+        if (patronGuard) {
+            builder = builder.addData("ks", {
+                keys: patronGuard.keys,
+                pred: patronGuard.pred,
+            });
+        }
+        // Add keyset data for account guard (if different from patron)
+        if (accountGuard && accountAddress !== patronAddress) {
+            builder = builder.addData("ks-account", {
+                keys: accountGuard.keys,
+                pred: accountGuard.pred,
+            });
+        }
+        builder = builder
+            .setMeta({
+            senderAccount: STOA_AUTONOMIC_OURONETGASSTATION,
+            creationTime: safeCreationTime(),
+            chainId: KADENA_CHAIN_ID,
+            gasLimit: gasLimitOverride || gasLimit,
+        })
+            .setNetworkId(KADENA_NETWORK)
+            // Gas Station key: GAS_PAYER capability (SEPARATE from guard keys)
+            .addSigner(gasStationKey.publicKey, (withCapability) => [
+            withCapability(`${KADENA_NAMESPACE}.DALOS.GAS_PAYER`, "", { int: 0 }, { decimal: "0.0" }),
+        ]);
+        // Patron guard signers — pure signing (ownership)
+        const addedSignerPubs = new Set([gasStationKey.publicKey]);
+        for (const k of patronGuardKeys) {
+            if (!addedSignerPubs.has(k.publicKey)) {
+                builder = builder.addSigner(k.publicKey);
+                addedSignerPubs.add(k.publicKey);
+            }
+        }
+        // Account guard signers — pure signing (ownership)
+        for (const k of accountGuardKeys) {
+            if (!addedSignerPubs.has(k.publicKey)) {
+                builder = builder.addSigner(k.publicKey);
+                addedSignerPubs.add(k.publicKey);
+            }
+        }
+        return builder.createTransaction();
+    };
+    const { dirtyRead, submit } = getFailoverClient(KADENA_CHAIN_ID);
+    let transaction = buildTransaction();
+    const simulation = await dirtyRead(transaction);
+    if (simulation.result.status === "failure") {
+        const error = createSimulationError("Rotate Payment Key", simulation.result, `Patron: ${patronAddress} | Account: ${accountAddress} | New Key: ${newPaymentKey}`);
+        logDetailedError(error);
+        throw error;
+    }
+    const requiredGas = simulation.gas;
+    if (requiredGas) {
+        gasLimit = calculateAutoGasLimit(requiredGas);
+        transaction = buildTransaction(gasLimit);
+    }
+    const signedTransaction = await universalSignTransaction(transaction, allSigners.map((s) => fromKeypair(s)));
+    return await submit(signedTransaction);
+}

package/dist/interactions/ouroSubCompressFunctions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ouroSubCompressFunctions.ts
+ * Sublimate (OURO -> IGNIS) and compress (IGNIS -> OURO) execution + preview/info reads.
+ */
+import type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+import type { IOuroAccountKeypair } from "./ouroTypes.js";
+export declare function sublimateOuroToIgnis(ouroAccount: IOuroAccountKeypair, kadenaAccount: IKadenaKeypair, guard: IKadenaKeypair, targetAccount: string, ouroAmount: string): Promise<import("@stoachain/kadena-stoic-legacy/client").ITransactionDescriptor>;
+export declare function compressIgnisToOuro(ouroAccount: IOuroAccountKeypair, kadenaAccount: IKadenaKeypair, guard: IKadenaKeypair, ignisAmount: string): Promise<import("@stoachain/kadena-stoic-legacy/client").ITransactionDescriptor>;
+export declare function getSublimatPreview(ouroAmount: string): Promise<{
+    ignis: number;
+    fee: number;
+} | null>;
+export declare function getCompressPreview(ignisAmount: string): Promise<{
+    ouro: number;
+    fee: number;
+} | null>;
+/**
+ * @deprecated Use `getSublimateInfo` from `@ouronet/ouronet-core/interactions/infoOneFunctions` instead.
+ * This compat shim accepts the legacy (patron, resident, amount-as-string) signature and forwards to the canonical
+ * (client, target, amount-as-number) form. Will be removed in v4.2.0.
+ */
+export declare function getSublimateInfo(a: string, b: string, c: string | number): Promise<any>;
+export declare function getCompressInfo(client: string, amount: string): Promise<any | null>;