@ouronet/ouronet-core 4.3.6

package/dist/interactions/errors.js

@@ -0,0 +1,13 @@
+/**
+ * Typed error for shape mismatches in Kadena RPC envelopes.
+ *
+ * Mirrors `InvalidEnvelopeError` (stoa-core/signing/partialSig.ts): extends
+ * Error (NOT TypeError — TypeError is reserved for input-validation seam
+ * errors), uses ES2022 Error.cause for original-envelope propagation.
+ */
+export class KadenaShapeError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "KadenaShapeError";
+    }
+}

package/dist/interactions/guardFunctions.d.ts

@@ -0,0 +1,33 @@
+import type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+export interface IDescribedKeyset {
+    keys: string[];
+    pred: string;
+}
+export interface RotateGuardParams {
+    patronAddress: string;
+    accountAddress: string;
+    mode: "define" | "existing";
+    newKeys?: string[];
+    newPred?: string;
+    keysetRef?: string;
+    safe: boolean;
+    gasStationKey: IKadenaKeypair;
+    patronGuardKeys: IKadenaKeypair[];
+    accountGuardKeys: IKadenaKeypair[];
+    newGuardKeys: IKadenaKeypair[];
+}
+/**
+ * Query RotateGuard info object from the chain.
+ * (ouronet-ns.DALOS-INFO.DALOS-INFO|URC_RotateGuard <patron> <account>)
+ */
+export declare function getRotateGuardInfo(patron: string, account: string): Promise<any | null>;
+/**
+ * Describe a keyset on-chain.
+ * (describe-keyset "keysetName")
+ */
+export declare function describeKeyset(keysetName: string): Promise<IDescribedKeyset>;
+/**
+ * Rotate Guard for an Ouronet account.
+ * (ouronet-ns.TS01-C1.DALOS|C_RotateGuard patron account GUARD_EXPR SAFE)
+ */
+export declare function rotateGuard(params: RotateGuardParams): Promise<import("@stoachain/kadena-stoic-legacy/client").ITransactionDescriptor>;

package/dist/interactions/guardFunctions.js

@@ -0,0 +1,110 @@
+import { calculateAutoGasLimit } from "@stoachain/stoa-core/gas";
+import { KADENA_CHAIN_ID, KADENA_NAMESPACE, STOA_AUTONOMIC_OURONETGASSTATION, KADENA_NETWORK, } from "../constants/index.js";
+import { Pact } from "@stoachain/kadena-stoic-legacy/client";
+import { getFailoverClient } from "@stoachain/stoa-core/network";
+import { pactRead } from "@stoachain/stoa-core/reads";
+import { universalSignTransaction, fromKeypair } from "@stoachain/stoa-core/signing";
+import { createSimulationError, logDetailedError } from "@stoachain/stoa-core/errors";
+import { safeCreationTime } from "@stoachain/stoa-core/pact";
+import { getLogger } from "@stoachain/stoa-core/observability";
+/**
+ * Query RotateGuard info object from the chain.
+ * (ouronet-ns.DALOS-INFO.DALOS-INFO|URC_RotateGuard <patron> <account>)
+ */
+export async function getRotateGuardInfo(patron, account) {
+    try {
+        const pactCode = `(${KADENA_NAMESPACE}.INFO-ZERO.DALOS-INFO|URC_RotateGuard "${patron}" "${account}")`;
+        const response = await pactRead(pactCode, { tier: "T7" });
+        if (response?.result?.status === "success") {
+            return response.result.data;
+        }
+        return null;
+    }
+    catch (error) {
+        getLogger().error("Error getting RotateGuard info:", error);
+        return null;
+    }
+}
+/**
+ * Describe a keyset on-chain.
+ * (describe-keyset "keysetName")
+ */
+export async function describeKeyset(keysetName) {
+    const pactCode = `(describe-keyset "${keysetName}")`;
+    const response = await pactRead(pactCode, { tier: "T7" });
+    if (response?.result?.status === "success") {
+        const data = response.result.data;
+        return { keys: data.keys, pred: data.pred };
+    }
+    throw new Error(response?.result?.error?.message || "Failed to describe keyset");
+}
+/**
+ * Rotate Guard for an Ouronet account.
+ * (ouronet-ns.TS01-C1.DALOS|C_RotateGuard patron account GUARD_EXPR SAFE)
+ */
+export async function rotateGuard(params) {
+    const { patronAddress, accountAddress, mode, newKeys, newPred, keysetRef, safe, gasStationKey, patronGuardKeys, accountGuardKeys, newGuardKeys, } = params;
+    let gasLimit = 2000000;
+    const guardExpr = mode === "define"
+        ? `(read-keyset "ks")`
+        : `(keyset-ref-guard "${keysetRef}")`;
+    // Collect all unique signers: gasStation + patronGuard + accountGuard + newGuard
+    const allSigners = [gasStationKey];
+    const addedPubs = new Set([gasStationKey.publicKey]);
+    for (const k of [...patronGuardKeys, ...accountGuardKeys, ...newGuardKeys]) {
+        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_RotateGuard "${patronAddress}" "${accountAddress}" ${guardExpr} ${safe})`);
+        // Add keyset data for "define" mode
+        if (mode === "define" && newKeys && newPred) {
+            builder = builder.addData("ks", {
+                keys: newKeys,
+                pred: newPred,
+            });
+        }
+        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
+            .addSigner(gasStationKey.publicKey, (withCapability) => [
+            withCapability(`${KADENA_NAMESPACE}.DALOS.GAS_PAYER`, "", { int: 0 }, { decimal: "0.0" }),
+        ]);
+        // All other keys: pure signers
+        const addedSignerPubs = new Set([gasStationKey.publicKey]);
+        for (const k of [
+            ...patronGuardKeys,
+            ...accountGuardKeys,
+            ...newGuardKeys,
+        ]) {
+            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 Guard", simulation.result, `Patron: ${patronAddress} | Account: ${accountAddress} | Mode: ${mode} | Safe: ${safe}`);
+        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/index.d.ts

@@ -0,0 +1 @@
+export * from "./ouroFunctions.js";

package/dist/interactions/index.js

@@ -0,0 +1,20 @@
+// @ouronet/ouronet-core/interactions
+//
+// Pact builders + submit helpers for every on-chain action OuronetUI (and
+// the future HUB backend) performs. Thirteen files in this directory — they
+// have overlapping symbol names, so consumers should import from specific
+// subpaths rather than via this barrel:
+//
+//   import { executeCoil } from "@ouronet/ouronet-core/interactions/wrapFunctions";
+//
+// IKadenaKeypair lives in @stoachain/stoa-core/signing — chain-generic key
+// shape, not Ouronet-specific. v4.0.0 removed the Phase-2b backwards-compat
+// re-declaration that previously lived in interactions/ouroFunctions.ts;
+// consumers should import directly:
+//
+//   import type { IKadenaKeypair } from "@stoachain/stoa-core/signing";
+//
+// This barrel re-exports only ouroFunctions (the canonical source for
+// IOuroAccountKeypair and the Ouronet-specific function-shaped types) for
+// the convenience of any caller that wants just those.
+export * from "./ouroFunctions.js";

package/dist/interactions/infoOneFunctions.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Parse transfer preview data to extract relevant information
+ */
+export interface TransferPreviewData {
+    ignisNeed: string;
+    ignisText: string;
+    preText: string[];
+    postText: string[];
+    kadenaFree: boolean;
+}
+export declare function parseTransferPreview(previewData: any): TransferPreviewData | null;
+/**
+ * Get transfer preview information
+ * (INFO-ONE.DPTF|INFO_Transfer patron id sender receiver transfer-amount)
+ */
+export declare function getTransferPreview(patronAddress: string, tokenId: string, senderAddress: string, receiverAddress: string, amount: string): Promise<{
+    result: any;
+} | null>;
+/**
+ * Get coil preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Coil patron coiler ats reward-token coil-amount)
+ */
+export declare function getCoilPreviewInfo(patronAddress: string, coilerAddress: string, atsId: string, rewardTokenId: string, amount: string): Promise<{
+    result: any;
+} | null>;
+/**
+ * Get curl preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Curl patron curler ats1 ats2 reward-token curl-amount)
+ */
+export declare function getCurlPreviewInfo(patronAddress: string, curlerAddress: string, ats1Id: string, ats2Id: string, rewardTokenId: string, amount: string): Promise<{
+    result: any;
+} | null>;
+/**
+ * Get brumate preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Brumate patron brumator ats1 ats2 reward-token brumate-amount dayz)
+ */
+export declare function getBrumatePreviewInfo(patronAddress: string, brumatorAddress: string, ats1Id: string, ats2Id: string, rewardTokenId: string, amount: string, lockDays: number): Promise<{
+    result: any;
+} | null>;
+/**
+ * Get constrict preview information from INFO-ONE
+ * (INFO-ONE.ATS|INFO_Constrict patron constricter ats reward-token constrict-amount dayz)
+ */
+export declare function getConstrictPreviewInfo(patronAddress: string, constracterAddress: string, atsId: string, rewardTokenId: string, amount: string, lockDays: number): Promise<{
+    result: any;
+} | null>;
+/**
+ * Get Sublimate info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.ORBR|INFO_Sublimate <client:string> <target:string> <ouro-amount:decimal>)
+ */
+export declare function getSublimateInfo(client: string, target: string, amount: number): Promise<any>;
+/**
+ * Get Firestarter info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_Firestarter <firestarter:string>)
+ */
+export declare function getFirestarterInfo(firestarter: string): Promise<any>;
+/**
+ * Get ChangeOwnership info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ChangeOwnership <patron> <swpair> <new-owner>)
+ */
+export declare function getChangeOwnershipInfo(patron: string, swpair: string, newOwner: string): Promise<any>;
+/**
+ * Get ModifyWeights info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ModifyWeights <patron> <swpair> <new-weights:[decimal]>)
+ */
+export declare function getModifyWeightsInfo(patron: string, swpair: string, newWeights: string[]): Promise<any>;
+/**
+ * Get ToggleSwapCapability info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ToggleSwapCapability <patron> <swpair> <toggle:bool>)
+ */
+export declare function getToggleSwapCapabilityInfo(patron: string, swpair: string, toggle: boolean): Promise<any>;
+/**
+ * Get ToggleAddLiquidity info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ToggleAddLiquidity <patron> <swpair> <toggle:bool>)
+ */
+export declare function getToggleAddLiquidityInfo(patron: string, swpair: string, toggle: boolean): Promise<any>;
+/**
+ * Get ModifyCanChangeOwner info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.SWP|INFO_ModifyCanChangeOwner <patron> <swpair> <new-boolean:bool>)
+ */
+export declare function getModifyCanChangeOwnerInfo(patron: string, swpair: string, newBoolean: boolean): Promise<any>;
+/**
+ * Get DPTF Transfer info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.DPTF|INFO_Transfer <patron> <token-id> <sender> <receiver> <amount>)
+ */
+export declare function getTransferInfo(patron: string, tokenId: string, sender: string, receiver: string, amount: number): Promise<any>;
+export declare function getRecoveryPrimordial(atsId: string, residentAddress: string): Promise<Record<string, any> | null>;
+export declare function getColdRecoveryInfo(patronAddress: string, recovererAddress: string, atsId: string, ra: string): Promise<any | null>;
+export declare function getDirectRecoveryInfo(patronAddress: string, recovererAddress: string, atsId: string, ra: string): Promise<any | null>;
+export declare function getMaxRecoveryAmount(atsId: string, residentAddress: string): Promise<string | null>;
+export declare function getCullInfo(patronAddress: string, cullerAddress: string, atsId: string): Promise<any>;
+export interface HibernatedNonce {
+    nonce: number;
+    "nonce-supply": number;
+    "mint-time": string;
+    "release-time": string;
+    "hibernating-fee-promile": number;
+    remainder: number;
+    "hibernating-fee": number;
+}
+export declare function getHibernatedNoncesDisplay(residentAccount: string, dpof: string, sortBy?: "nonce" | "fee-promile"): Promise<HibernatedNonce[] | null>;
+export declare function getAwakeInfo(patron: string, awaker: string, dpof: string, nonce: number): Promise<Record<string, unknown> | null>;
+export declare function getSlumberInfo(patron: string, merger: string, dpof: string, nonces: number[]): Promise<Record<string, unknown> | null>;
+/**
+ * Get ClearDispo preview info from INFO-ONE
+ * (ouronet-ns.INFO-ONE.DPTF|INFO_ClearDispo <patron:string> <account:string>)
+ */
+export declare function getClearDispoInfo(patronAddress: string, accountAddress: string): Promise<any>;
+/**
+ * INFO_AddLiquidity — dirty read for add liquidity preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_AddLiquidity patron account swpair input-amounts kda-pid)
+ */
+export declare function getInfoAddLiquidity(patron: string, account: string, swpair: string, inputAmounts: string[], kdaPid: string): Promise<any | null>;
+/**
+ * INFO_Fuel — dirty read for fuel preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_Fuel patron account swpair input-amounts)
+ */
+export declare function getInfoFuel(patron: string, account: string, swpair: string, inputAmounts: string[]): Promise<any | null>;
+/**
+ * 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 declare function getInfoSinglePoolSwap(patron: string, account: string, swpair: string, inputId: string, inputAmount: string, outputId: string): Promise<any | 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 declare function getInfoMultiPoolSwap(patron: string, account: string, swpair: string, inputIds: string[], inputAmounts: string[], outputId: string): Promise<any | null>;
+/**
+ * INFO_RemoveLiquidity — dirty read for remove liquidity (unfold) preview.
+ * (ouronet-ns.INFO-ONE.SWP|INFO_RemoveLiquidity patron account swpair lp-amount)
+ */
+export declare function getInfoRemoveLiquidity(patron: string, account: string, swpair: string, lpAmount: string): Promise<any | null>;