@ouronet/ouronet-core 4.3.6

package/dist/interactions/infoOneFunctions.js

@@ -0,0 +1,566 @@
+import { KADENA_NAMESPACE, } from "../constants/index.js";
+import { formatDecimalForPact } from "@stoachain/stoa-core/pact";
+import { pactRead } from "@stoachain/stoa-core/reads";
+import { getLogger } from "@stoachain/stoa-core/observability";
+export function parseTransferPreview(previewData) {
+    if (!previewData?.result)
+        return null;
+    const data = previewData.result;
+    return {
+        ignisNeed: String(data.ignis?.["ignis-need"] || "0"),
+        ignisText: data.ignis?.["ignis-text"] || "",
+        preText: data["pre-text"] || [],
+        postText: data["post-text"] || [],
+        kadenaFree: data.kadena?.["kadena-need"] === 0,
+    };
+}
+/**
+ * Get transfer preview information
+ * (INFO-ONE.DPTF|INFO_Transfer patron id sender receiver transfer-amount)
+ */
+export async function getTransferPreview(patronAddress, tokenId, senderAddress, receiverAddress, amount) {
+    try {
+        const decimalAmount = formatDecimalForPact(amount);
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.DPTF|INFO_Transfer "${patronAddress}" "${tokenId}" "${senderAddress}" "${receiverAddress}" ${decimalAmount})`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return { result: response.result.data };
+    }
+    catch (error) {
+        getLogger().error("Error getting transfer preview:", error);
+        return null;
+    }
+}
+/**
+ * Get coil preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Coil patron coiler ats reward-token coil-amount)
+ */
+export async function getCoilPreviewInfo(patronAddress, coilerAddress, atsId, rewardTokenId, amount) {
+    try {
+        const decimalAmount = formatDecimalForPact(amount);
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_Coil "${patronAddress}" "${coilerAddress}" "${atsId}" "${rewardTokenId}" ${decimalAmount})`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return { result: response.result.data };
+    }
+    catch (error) {
+        getLogger().error("Error getting coil preview:", error);
+        return null;
+    }
+}
+/**
+ * Get curl preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Curl patron curler ats1 ats2 reward-token curl-amount)
+ */
+export async function getCurlPreviewInfo(patronAddress, curlerAddress, ats1Id, ats2Id, rewardTokenId, amount) {
+    try {
+        const decimalAmount = formatDecimalForPact(amount);
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_Curl "${patronAddress}" "${curlerAddress}" "${ats1Id}" "${ats2Id}" "${rewardTokenId}" ${decimalAmount})`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return { result: response.result.data };
+    }
+    catch (error) {
+        getLogger().error("Error getting curl preview:", error);
+        return null;
+    }
+}
+/**
+ * Get brumate preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Brumate patron brumator ats1 ats2 reward-token brumate-amount dayz)
+ */
+export async function getBrumatePreviewInfo(patronAddress, brumatorAddress, ats1Id, ats2Id, rewardTokenId, amount, lockDays) {
+    try {
+        const decimalAmount = formatDecimalForPact(amount);
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_Brumate "${patronAddress}" "${brumatorAddress}" "${ats1Id}" "${ats2Id}" "${rewardTokenId}" ${decimalAmount} ${lockDays})`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return { result: response.result.data };
+    }
+    catch (error) {
+        getLogger().error("Error getting brumate preview:", error);
+        return null;
+    }
+}
+/**
+ * Get constrict preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Constrict patron constricter ats reward-token constrict-amount dayz)
+ */
+export async function getConstrictPreviewInfo(patronAddress, constracterAddress, atsId, rewardTokenId, amount, lockDays) {
+    try {
+        const decimalAmount = formatDecimalForPact(amount);
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_Constrict "${patronAddress}" "${constracterAddress}" "${atsId}" "${rewardTokenId}" ${decimalAmount} ${lockDays})`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return { result: response.result.data };
+    }
+    catch (error) {
+        getLogger().error("Error getting constrict preview:", error);
+        return null;
+    }
+}
+/**
+ * Get Sublimate info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.ORBR|INFO_Sublimate <client:string> <target:string> <ouro-amount:decimal>)
+ */
+export async function getSublimateInfo(client, target, amount) {
+    try {
+        const decimalAmount = amount % 1 === 0 ? `${amount}.0` : String(amount);
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.ORBR|INFO_Sublimate "${client}" "${target}" ${decimalAmount})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting sublimate info:", error);
+        return null;
+    }
+}
+/**
+ * Get Firestarter info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_Firestarter <firestarter:string>)
+ */
+export async function getFirestarterInfo(firestarter) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_Firestarter "${firestarter}")`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting firestarter info:", error);
+        return null;
+    }
+}
+/**
+ * Get ChangeOwnership info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ChangeOwnership <patron> <swpair> <new-owner>)
+ */
+export async function getChangeOwnershipInfo(patron, swpair, newOwner) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_ChangeOwnership "${patron}" "${swpair}" "${newOwner}")`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting change-ownership info:", error);
+        return null;
+    }
+}
+/**
+ * Get ModifyWeights info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ModifyWeights <patron> <swpair> <new-weights:[decimal]>)
+ */
+export async function getModifyWeightsInfo(patron, swpair, newWeights) {
+    try {
+        const weightList = `[${newWeights.map(w => {
+            const s = String(w);
+            return s.includes(".") ? s : `${s}.0`;
+        }).join(" ")}]`;
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_ModifyWeights "${patron}" "${swpair}" ${weightList})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting modify-weights info:", error);
+        return null;
+    }
+}
+/**
+ * Get ToggleSwapCapability info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ToggleSwapCapability <patron> <swpair> <toggle:bool>)
+ */
+export async function getToggleSwapCapabilityInfo(patron, swpair, toggle) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_ToggleSwapCapability "${patron}" "${swpair}" ${toggle})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting toggle-swap-capability info:", error);
+        return null;
+    }
+}
+/**
+ * Get ToggleAddLiquidity info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ToggleAddLiquidity <patron> <swpair> <toggle:bool>)
+ */
+export async function getToggleAddLiquidityInfo(patron, swpair, toggle) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_ToggleAddLiquidity "${patron}" "${swpair}" ${toggle})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting toggle-add-liquidity info:", error);
+        return null;
+    }
+}
+/**
+ * Get ModifyCanChangeOwner info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ModifyCanChangeOwner <patron> <swpair> <new-boolean:bool>)
+ */
+export async function getModifyCanChangeOwnerInfo(patron, swpair, newBoolean) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_ModifyCanChangeOwner "${patron}" "${swpair}" ${newBoolean})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting modify-can-change-owner info:", error);
+        return null;
+    }
+}
+/**
+ * Get DPTF Transfer info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.DPTF|INFO_Transfer <patron> <token-id> <sender> <receiver> <amount>)
+ */
+export async function getTransferInfo(patron, tokenId, sender, receiver, amount) {
+    try {
+        const decimalAmount = amount % 1 === 0 ? `${amount}.0` : String(amount);
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.DPTF|INFO_Transfer "${patron}" "${tokenId}" "${sender}" "${receiver}" ${decimalAmount})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting transfer info:", error);
+        return null;
+    }
+}
+// ── Recovery Primordial read ─────────────────────────────────────────────────
+// (ouronet-ns.DPL-UR.URC_0012_RecoveryPrimordial <ats:string> <resident:string>)
+export async function getRecoveryPrimordial(atsId, residentAddress) {
+    try {
+        const response = await pactRead(`(${KADENA_NAMESPACE}.DPL-UR.URC_0012_RecoveryPrimordial "${atsId}" "${residentAddress}")`, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure") {
+            return null;
+        }
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error getting recovery primordial:", error);
+        return null;
+    }
+}
+// ── Cold Recovery Info ────────────────────────────────────────────────────────
+// (ouronet-ns.INFO-ONE.ATS|INFO_ColdRecovery <patron:string> <recoverer:string> <ats:string> <ra:decimal>)
+export async function getColdRecoveryInfo(patronAddress, recovererAddress, atsId, ra) {
+    try {
+        const decimalRa = ra.includes(".") ? ra : ra + ".0";
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_ColdRecovery "${patronAddress}" "${recovererAddress}" "${atsId}" ${decimalRa})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error getting cold recovery info:", error);
+        return null;
+    }
+}
+// ── Direct Recovery Info ───────────────────────────────────────────────────────
+// (ouronet-ns.INFO-ONE.ATS|INFO_DirectRecovery <patron:string> <recoverer:string> <ats:string> <ra:decimal>)
+export async function getDirectRecoveryInfo(patronAddress, recovererAddress, atsId, ra) {
+    try {
+        const decimalRa = ra.includes(".") ? ra : ra + ".0";
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_DirectRecovery "${patronAddress}" "${recovererAddress}" "${atsId}" ${decimalRa})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error getting direct recovery info:", error);
+        return null;
+    }
+}
+// ── Elite Max Recovery Amount ──────────────────────────────────────────────────
+// (ouronet-ns.DPL-UR.URC_MaxRecoveryAmount <ats:string> <recoverer:string>)
+// Returns the max RBT amount a resident can uncoil while preserving their Elite tier.
+export async function getMaxRecoveryAmount(atsId, residentAddress) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.DPL-UR.URC_MaxRecoveryAmount "${atsId}" "${residentAddress}")`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        const raw = response.result.data;
+        if (raw === undefined || raw === null)
+            return null;
+        // Result may be decimal object {decimal:"..."} or plain number
+        if (typeof raw === "object" && raw.decimal !== undefined)
+            return String(raw.decimal);
+        return String(raw);
+    }
+    catch (error) {
+        getLogger().error("Error getting max recovery amount:", error);
+        return null;
+    }
+}
+// ── Cull Info ─────────────────────────────────────────────────────────────────
+// (ouronet-ns.INFO-ONE.ATS|INFO_Cull <patron:string> <culler:string> <ats:string>)
+export async function getCullInfo(patronAddress, cullerAddress, atsId) {
+    const r = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.ATS|INFO_Cull "${patronAddress}" "${cullerAddress}" "${atsId}")`, { tier: "T2" });
+    if (!r?.result || r.result.status === "failure")
+        return null;
+    return r.result.data ?? null;
+}
+/** Normalize Pact primitive wrappers → plain JS values.
+ *  Handles: {int: N} → number, {decimal: "..."} → number
+ *  Time objects are handled separately by normalizePactTime. */
+function normalizePactValue(v) {
+    if (v === null || v === undefined)
+        return v;
+    if (typeof v === "object" && !Array.isArray(v)) {
+        const o = v;
+        if ("int" in o)
+            return Number(o["int"]);
+        if ("decimal" in o)
+            return parseFloat(String(o["decimal"]));
+    }
+    return v;
+}
+/**
+ * Normalize a Pact time value to an ISO 8601 string that new Date() can parse.
+ * Pact returns time as: {time: "YYYY-MM-DDThh:mm:ss.000000Z"} or similar.
+ * We extract the inner string and ensure it's a valid ISO string.
+ */
+function normalizePactTime(v) {
+    let raw = "";
+    if (typeof v === "string") {
+        raw = v;
+    }
+    else if (typeof v === "object" && v !== null && !Array.isArray(v)) {
+        const o = v;
+        // Pact wraps time as {timep: "..."} (Pact's actual key)
+        // Also handle {time: "..."} as fallback
+        if ("timep" in o)
+            raw = String(o["timep"]);
+        else if ("time" in o)
+            raw = String(o["time"]);
+    }
+    if (!raw)
+        return "";
+    // Ensure it ends with Z if no timezone info
+    if (!raw.endsWith("Z") && !raw.includes("+"))
+        raw = raw + "Z";
+    return raw;
+}
+function normalizeNonce(raw) {
+    return {
+        nonce: Number(normalizePactValue(raw["nonce"]) ?? 0),
+        "nonce-supply": Number(normalizePactValue(raw["nonce-supply"]) ?? 0),
+        "mint-time": normalizePactTime(raw["mint-time"]),
+        "release-time": normalizePactTime(raw["release-time"]),
+        "hibernating-fee-promile": Number(normalizePactValue(raw["hibernating-fee-promile"]) ?? 0),
+        remainder: Number(normalizePactValue(raw["remainder"]) ?? 0),
+        "hibernating-fee": Number(normalizePactValue(raw["hibernating-fee"]) ?? 0),
+    };
+}
+export async function getHibernatedNoncesDisplay(residentAccount, dpof, sortBy) {
+    try {
+        const inner = `(${KADENA_NAMESPACE}.INFO-ONE.VST|INFO-HibernatedNoncesDisplay "${residentAccount}" "${dpof}")`;
+        const pactCode = sortBy === "fee-promile"
+            ? `(sort ["hibernating-fee-promile"] ${inner})`
+            : inner;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        const data = response.result.data;
+        if (!Array.isArray(data))
+            return null;
+        // Normalize all Pact primitive wrappers ({int:N}, {decimal:"..."}, {time:"..."})
+        return data.map(normalizeNonce);
+    }
+    catch (error) {
+        getLogger().error("Error getting hibernated nonces:", error);
+        return null;
+    }
+}
+// ── Awake Info ────────────────────────────────────────────────────────────────
+// (ouronet-ns.INFO-ONE.VST|INFO_Awake <patron> <awaker> <dpof> <nonce>)
+export async function getAwakeInfo(patron, awaker, dpof, nonce) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.VST|INFO_Awake "${patron}" "${awaker}" "${dpof}" ${nonce})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error getting awake info:", error);
+        return null;
+    }
+}
+// ── Slumber Info ──────────────────────────────────────────────────────────────
+// (ouronet-ns.INFO-ONE.VST|INFO_Slumber <patron> <merger> <dpof> <nonces:[integer]>)
+export async function getSlumberInfo(patron, merger, dpof, nonces) {
+    try {
+        const nonceList = `[${nonces.join(" ")}]`;
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.VST|INFO_Slumber "${patron}" "${merger}" "${dpof}" ${nonceList})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response || !response.result || response.result.status === "failure")
+            return null;
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error getting slumber info:", error);
+        return null;
+    }
+}
+/**
+ * Get ClearDispo preview info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.DPTF|INFO_ClearDispo <patron:string> <account:string>)
+ */
+export async function getClearDispoInfo(patronAddress, accountAddress) {
+    try {
+        const response = await pactRead(`(${KADENA_NAMESPACE}.INFO-ONE.DPTF|INFO_ClearDispo "${patronAddress}" "${accountAddress}")`, { tier: "T2" });
+        if (response.result.status === "failure")
+            return null;
+        return response.result.data ?? null;
+    }
+    catch (error) {
+        getLogger().error("Error in getClearDispoInfo:", error);
+        return null;
+    }
+}
+// ── Add Liquidity INFO function ───────────────────────────────────────────────
+/**
+ * INFO_AddLiquidity — dirty read for add liquidity preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_AddLiquidity patron account swpair input-amounts kda-pid)
+ */
+export async function getInfoAddLiquidity(patron, account, swpair, inputAmounts, kdaPid) {
+    try {
+        const pactInputAmounts = `[${inputAmounts.map(a => {
+            const s = String(a || "0");
+            return s.includes(".") ? s : s + ".0";
+        }).join(" ")}]`;
+        const decKdaPid = kdaPid.includes(".") ? kdaPid : kdaPid + ".0";
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_AddLiquidity "${patron}" "${account}" "${swpair}" ${pactInputAmounts} ${decKdaPid})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response?.result || response.result.status === "failure")
+            return null;
+        return response.result.data;
+    }
+    catch (error) {
+        getLogger().error("getInfoAddLiquidity error:", error);
+        return null;
+    }
+}
+/**
+ * INFO_Fuel — dirty read for fuel preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_Fuel patron account swpair input-amounts)
+ */
+export async function getInfoFuel(patron, account, swpair, inputAmounts) {
+    try {
+        const pactInputAmounts = `[${inputAmounts.map(a => {
+            const s = String(a || "0");
+            return s.includes(".") ? s : s + ".0";
+        }).join(" ")}]`;
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_Fuel "${patron}" "${account}" "${swpair}" ${pactInputAmounts})`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response?.result || response.result.status === "failure")
+            return null;
+        return response.result.data;
+    }
+    catch (error) {
+        getLogger().error("getInfoFuel error:", error);
+        return null;
+    }
+}
+// ── Swap INFO functions ───────────────────────────────────────────────────────
+/**
+ * INFO_SinglePoolSwap — dirty read for single-input swap preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_SinglePoolSwap patron account swpair input-id input-amount output-id)
+ */
+export async function getInfoSinglePoolSwap(patron, account, swpair, inputId, inputAmount, outputId) {
+    try {
+        const decAmount = formatDecimalForPact(inputAmount);
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_SinglePoolSwap "${patron}" "${account}" "${swpair}" "${inputId}" ${decAmount} "${outputId}")`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response?.result || response.result.status === "failure")
+            return null;
+        return response.result.data;
+    }
+    catch (error) {
+        getLogger().error("getInfoSinglePoolSwap error:", error);
+        return null;
+    }
+}
+/**
+ * INFO_MultiPoolSwap — dirty read for multi-input swap preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_MultiPoolSwap patron account swpair input-ids input-amounts output-id)
+ */
+export async function getInfoMultiPoolSwap(patron, account, swpair, inputIds, inputAmounts, outputId) {
+    try {
+        const pactInputIds = `[${inputIds.map(id => `"${id}"`).join(" ")}]`;
+        const pactInputAmounts = `[${inputAmounts.map(a => {
+            const s = String(a);
+            return s.includes(".") ? s : s + ".0";
+        }).join(" ")}]`;
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_MultiPoolSwap "${patron}" "${account}" "${swpair}" ${pactInputIds} ${pactInputAmounts} "${outputId}")`;
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response?.result || response.result.status === "failure")
+            return null;
+        return response.result.data;
+    }
+    catch (error) {
+        getLogger().error("getInfoMultiPoolSwap error:", error);
+        return null;
+    }
+}
+/**
+ * INFO_RemoveLiquidity — dirty read for remove liquidity (unfold) preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_RemoveLiquidity patron account swpair lp-amount)
+ */
+export async function getInfoRemoveLiquidity(patron, account, swpair, lpAmount) {
+    try {
+        const decLpAmount = lpAmount.includes(".") ? lpAmount : lpAmount + ".0";
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ONE.SWP|INFO_RemoveLiquidity "${patron}" "${account}" "${swpair}" ${decLpAmount})`;
+        // v3.3.0 (closes part of consolidated F-LOGGER-SEAM-001): the two
+        // `console.log` debug-leak calls that used to live here were leftover
+        // dev instrumentation (per-keystroke pretty-printed `JSON.stringify`
+        // dumps that bypassed the seam AND added serialisation cost on every
+        // preview read). The legitimate diagnostic — the FAILED warn call
+        // below — already routes through the seam. Removing the debug-only
+        // calls is the audit-recommended outcome (per the F-LOGGER-SEAM-001
+        // validator's "should be removed or routed" classification — these
+        // had no operational value beyond developer-side trace).
+        const response = await pactRead(pactCode, { tier: "T2" });
+        if (!response?.result || response.result.status === "failure") {
+            getLogger().warn("[INFO_RemoveLiquidity] FAILED:", response?.result?.error?.message);
+            return null;
+        }
+        return response.result.data;
+    }
+    catch (error) {
+        getLogger().error("getInfoRemoveLiquidity error:", error);
+        return null;
+    }
+}

package/dist/interactions/kadenaFunctions.d.ts

@@ -0,0 +1,11 @@
+export interface BalanceItem {
+    account: string;
+    balance: string;
+}
+export declare function getBalance(account: string): Promise<BalanceItem>;
+export declare function accountDescription(address: string): Promise<{
+    isNewAccount: boolean;
+    balance: any;
+    account: any;
+    guard: any;
+}>;

package/dist/interactions/kadenaFunctions.js

@@ -0,0 +1,40 @@
+import { pactRead } from "@stoachain/stoa-core/reads";
+import { KadenaShapeError } from "./errors.js";
+export async function getBalance(account) {
+    const pactCode = `(coin.get-balance "${account}")`;
+    const response = await pactRead(pactCode, { tier: "T1" });
+    const raw = response.result.data;
+    let balance;
+    if (raw !== null && raw !== undefined && typeof raw === "object" && "decimal" in raw) {
+        // Kadena may return { decimal: "..." } — unwrap to plain string
+        balance = String(raw.decimal);
+    }
+    else if (typeof raw === "string") {
+        balance = raw;
+    }
+    else {
+        throw new KadenaShapeError("Unexpected balance envelope", { cause: response.result });
+    }
+    return { account, balance };
+}
+export async function accountDescription(address) {
+    const pactCode = `(coin.details "${address}")`;
+    const { result } = await pactRead(pactCode, { tier: "T5" });
+    if (result?.status === "failure") {
+        return {
+            isNewAccount: true,
+            balance: undefined,
+            account: result?.data?.account || address,
+            guard: result?.data?.guard || null,
+        };
+    }
+    if (result?.data?.balance === undefined || result?.data?.balance === null) {
+        throw new KadenaShapeError("Account description envelope missing balance field", { cause: result });
+    }
+    return {
+        isNewAccount: false,
+        balance: result.data.balance,
+        account: result?.data?.account || address,
+        guard: result?.data?.guard || null,
+    };
+}

package/dist/interactions/kpayFunctions.d.ts

@@ -0,0 +1,45 @@
+import type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+export type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+export interface IOuroAccountKeypair {
+    address: string;
+    publicKey: string;
+    privateKey?: string;
+}
+/**
+ * Get KPay data for a specific Ouro account
+ * @param account - Ouro account address
+ * @returns KPay data object or null on failure
+ */
+export declare function getKpayData(account: string): Promise<any>;
+/**
+ * Get cost for specific amount of KPAY tokens with future price projection
+ * @param amount - Amount of KPAY tokens (integer)
+ * @param futureSeconds - Seconds in the future to calculate price (default 900 = 15 minutes)
+ * @returns Object with pid (price in dollars) and wkda (WSTOA amount) or null
+ */
+export declare function getKpayAmountCosts(amount: number, futureSeconds?: number): Promise<{
+    pid: string;
+    wkda: string;
+} | null>;
+/**
+ * Get required capabilities for KPAY acquisition
+ * @param buyer - Buyer Ouro account address
+ * @param amount - Amount of KPAY tokens (integer)
+ * @param isNative - true for KDA native, false for WSTOA
+ * @returns Array of capability strings or null
+ */
+export declare function getKpayAcquireCapabilities(buyer: string, amount: number, isNative: boolean): Promise<string[] | null>;
+/**
+ * Buy KPAY tokens with KDA or WSTOA
+ * @param patronAccount - Patron Ouro account
+ * @param buyerAccount - Buyer Ouro address (usually same as patron)
+ * @param kpayAmount - Amount of KPAY tokens to buy (integer)
+ * @param isNative - true for KDA native, false for WSTOA
+ * @param kadenaAccount - Kadena account for gas and payments
+ * @param guardAccount - Guard account from Ouro account
+ * @returns Transaction result
+ */
+export declare function kpayBuy(patronAccount: IOuroAccountKeypair, buyerAccount: string, kpayAmount: number, isNative: boolean, kadenaAccount: IKadenaKeypair, guardAccount: IKadenaKeypair, guardKeyset: {
+    keys: string[];
+    pred: "keys-all" | "keys-any" | "keys-2";
+}): Promise<any>;