@ouronet/ouronet-core 4.4.0 → 4.5.0

package/CHANGELOG.md

@@ -4,6 +4,43 @@ All notable changes to `@ouronet/ouronet-core`.
 
 This package is the historical continuation of `@ouronet/ouronet-core` v0.x–v3.3.8. v4.0.0 split it into a two-package npm workspace under `StoaChain/stoa-js` — chain-generic infrastructure moved out into [`@stoachain/stoa-core`](https://www.npmjs.com/package/@stoachain/stoa-core), this package retained the Ouronet-specific business logic. The `4.0.0` heading below is the first release after the split.
 
+## 4.5.0 — 2026-09-07
+
+**MINOR — cross-chain gas payer switched to `stoa-xchain-gas`; live Yin-Engine gas pricing.**
+
+### What changed
+
+`crossChainFunctions.ts`'s non-chain-0 gas payer moves off the legacy `kadena-xchain-gas`
+account (a static `gasPrice <= 0.00000001` / `gasLimit <= 850` guard) onto StoaChain's own
+`stoa-xchain-gas` account. Its guard (`pact/genesis/stoa/stoa-genesis-5.pact`) requires
+`gasPrice <= UC_MinimumGasPriceANU()` — a **live floor**, not a fixed ceiling — so a hardcoded
+price would eventually either be rejected by this guard's ceiling (once the floor rises above
+whatever was hardcoded, that part is safe) or, more importantly, fall **below** the chain-wide
+minimum price the Yin Engine enforces post-fork.
+
+All four `gasPrice` call sites in this file now derive `{ creationTime, gasPrice }` from a
+single local Yin-Engine helper instead of a hardcoded number or the static `GAS_PRICE_MIN_ANU`:
+
+- `buildCrossChainTransfer` (legacy single-step `coin.transfer-crosschain`, self-paid gas)
+- `buildCTransferAcross` — chain-0 branch (`DALOS.GAS_PAYER`, previously on the static
+  `anuToStoa(GAS_PRICE_MIN_ANU)`)
+- `buildCTransferAcross` — non-chain-0 branch (now `stoa-xchain-gas`, was `kadena-xchain-gas`)
+- `buildContinuationTransaction` — default `gasPayerAccount` (now `stoa-xchain-gas`)
+
+The Yin-Engine helper is a **temporary local duplicate** of OuronetUI's `src/lib/gas-price.ts`
+(same constants, same formula — genesis 10,000 ANU, +1 ANU/3h, capped at 400,000 ANU). It
+belongs in `@stoachain/stoa-core/gas` once that package ships the same formula; that package
+currently still only exports the static `GAS_PRICE_MIN_ANU = 10_000`. Consolidate then.
+
+### Verification
+
+Confirmed against a live StoaChain node (not just simulated): both the initial
+`C_TransferAcross` (chain-0, `DALOS.GAS_PAYER`) and the `stoa-xchain-gas`-paid continuation
+landed successfully at **11,565 ANU/gas**, the live floor at time of testing.
+
+Non-breaking. No exported function signatures changed — only the default `gasPayerAccount`
+value and the internal price derivation. **787 specs pass.**
+
 ## 4.4.0 — 2026-07-22
 
 **MINOR — the codex writer is held at `"1.2"` while the reader keeps accepting `"1.2"` and `"1.3"`.**

package/README.md

@@ -23,6 +23,8 @@ Chain-generic infrastructure (signing, wallet, crypto, network failover, gas, gu
 
 ## Status
 
+**`4.5.0` on public npmjs** — **MINOR (cross-chain gas payer switched to `stoa-xchain-gas`; live Yin-Engine gas pricing).** Released 2026-09-07. `crossChainFunctions.ts`'s non-chain-0 gas payer moves off the legacy `kadena-xchain-gas` account (a static `gasPrice <= 0.00000001` / `gasLimit <= 850` guard) onto StoaChain's own `stoa-xchain-gas` account, whose guard (`pact/genesis/stoa/stoa-genesis-5.pact`) requires `gasPrice <= UC_MinimumGasPriceANU()` — a *live floor*, not a fixed ceiling. All four `gasPrice` call sites in this file (the legacy `buildCrossChainTransfer`, both `buildCTransferAcross` branches — including the chain-0 `DALOS.GAS_PAYER` path, previously on the static `GAS_PRICE_MIN_ANU` — and `buildContinuationTransaction`'s default payer) now derive `{ creationTime, gasPrice }` from a local Yin-Engine helper instead of a hardcoded price. That helper is a temporary duplicate of OuronetUI's `src/lib/gas-price.ts` — it belongs in `@stoachain/stoa-core/gas` once that package ships the same formula (it currently still exports only the static `GAS_PRICE_MIN_ANU = 10_000`); consolidate then. Verified against a live StoaChain node: both the initial `C_TransferAcross` (chain-0, `DALOS.GAS_PAYER`) and the `stoa-xchain-gas`-paid continuation landed successfully at 11,565 ANU/gas. Non-breaking — no exported signatures changed, only the default `gasPayerAccount` value and the internal price derivation. **787 specs pass.**
+
 **`4.4.0` on public npmjs** — **MINOR (codec writer held at 1.2; reader still accepts 1.2 and 1.3).** Released 2026-07-22. Corrects 4.3.6/4.3.7, which shipped an unreleased 1.3 *writer* and so produced backups that apps on a 1.2-only reader could not open. The reader is unchanged and still accepts both, so any 1.3 file already written stays readable; the writer stamps 1.2 again. Nothing is lost — this writer never emitted the 1.3-only `foreignKeys` block. Those two versions are deprecated and point here. **787 specs pass.**
 
 **`4.3.7` on public npmjs** — **PATCH (chain-peer realignment with `@stoachain/stoa-core@4.3.7` + `@stoachain/kadena-stoic-legacy@4.3.7`).** Released 2026-07-22. NO code changes in this package. The exact chain peers move 4.3.6 → 4.3.7 so consumers resolving the current chain layer get a satisfiable tree; stoa-js 4.3.7 repointed DALOS onto `@ouronet/dalos-crypto@4.0.4`. **785 specs pass.**
@@ -45,6 +47,8 @@ Chain-generic infrastructure (signing, wallet, crypto, network failover, gas, gu
 
 **`4.2.0` on public npmjs** — **MINOR (atomic with `@stoachain/stoa-core@4.2.0` + `@stoachain/kadena-stoic-legacy@4.2.0`).** Released 2026-05-09. Closes 6 audit findings: **F-ARCH-001** (Phase 1 dex god-file split — ~10 entity-oriented files + thin re-export shim), **F-ARCH-002** (Phase 2 ouro god-file split + chain/UI surgical separation — ~11 entity-oriented files + thin re-export shim), **F-ARCH-003** (Phase 3 parameterized liquidity executor — 5 thin wrappers + 1 internal `executeLiquidityOp`, LOC reduction ~600 → ~200), **F-API-002** (Phase 4 — 12 functions honor declared `Promise<T | null>` contract, return null on RPC failure instead of rethrowing), **F-API-018** (Phase 5 readonly sweep — ~50 public-type fields in `codex/types.ts` and all `*Params` interfaces), **F-TEST-006** (Phase 7 — +127 specs across 6 modules: `infoOneFunctions`, `coilFunctions`, `kpayFunctions`, `pensionFunctions`, `activateFunctions`, `guardFunctions`). NEW deliverable: [`INTEGRATION-GUIDE.md`](https://github.com/StoaChain/stoa-js/blob/main/INTEGRATION-GUIDE.md) at repo root — comprehensive cold-start consumer onboarding doc, 13 sections, full v4.0 → v4.1 → v4.2 architectural arc. 8 new `v4-2-0-*.test.ts` regression-lock files. Test count: **710 specs pass** (was ~330 in v4.1.1). Cross-reference: see [`MIGRATION-v4.2.md`](https://github.com/StoaChain/stoa-js/blob/main/MIGRATION-v4.2.md) at the monorepo root.
 
+**v4.5.0** — cross-chain gas payer switched to `stoa-xchain-gas` with live Yin-Engine pricing (replaces the legacy `kadena-xchain-gas` static ceiling). Released 2026-09-07. All four `gasPrice` sites in `crossChainFunctions.ts` now derive price from the current Yin floor instead of a hardcoded value; verified landing on a live StoaChain node at 11,565 ANU/gas. No signature changes. **787 specs pass.**
+
 **v4.4.0** — codec writer held at `"1.2"`; reader still accepts `"1.2"` and `"1.3"`. Released 2026-07-22. Corrects the 4.3.6/4.3.7 mispublish, which shipped an unreleased 1.3 writer under version numbers the old `@stoachain` package had already used. **787 specs pass.**
 
 **v4.3.7** — chain-peer realignment bump (exact peers on `@stoachain/stoa-core@4.3.7` + `@stoachain/kadena-stoic-legacy@4.3.7`). Released 2026-07-22. NO code changes. Required because this package pins its chain peers exactly and stoa-js now releases independently. **785 specs pass.**

package/dist/interactions/crossChainFunctions.d.ts

@@ -53,7 +53,7 @@ export interface CTransferAcrossParams {
  * Build a coin.C_TransferAcross transaction (step 0 of cross-chain transfer).
  *
  * Chain 0: Gas paid by Ouronet Gas Station (DALOS.GAS_PAYER).
- * Other chains: Gas paid by kadena-xchain-gas (unsigned).
+ * Other chains: Gas paid by stoa-xchain-gas (unsigned).
  */
 export declare function buildCTransferAcross(params: CTransferAcrossParams): any;
 /**

package/dist/interactions/crossChainFunctions.js

@@ -1,9 +1,49 @@
 import { Pact } from "@stoachain/kadena-stoic-legacy/client";
 import { getFailoverClient, withFailover } from "@stoachain/stoa-core/network";
 import { KADENA_NETWORK, getPactUrl, STOA_AUTONOMIC_OURONETGASSTATION, KADENA_NAMESPACE } from "../constants/index.js";
-import { GAS_PRICE_MIN_ANU, anuToStoa } from "@stoachain/stoa-core/gas";
 import { pactRead } from "@stoachain/stoa-core/reads";
 import { safeCreationTime, formatDecimalForPact } from "@stoachain/stoa-core/pact";
+/**
+ * Yin Engine — StoaChain's time-varying minimum gas price.
+ *
+ * TEMPORARY LOCAL COPY. This mirrors `OuronetUI/src/lib/gas-price.ts` exactly
+ * (same constants, same formula) because `@stoachain/stoa-core/gas` has not
+ * yet been upgraded past the static `GAS_PRICE_MIN_ANU = 10_000`. It belongs
+ * there long-term (chain-generic, not Ouronet-specific) — consolidate this
+ * away once stoa-core ships it.
+ *
+ * The floor starts at 10,000 ANU at genesis and rises by 1 ANU every 3 hours,
+ * capped at 400,000 ANU. Source of truth: `UC_MinimumGasPriceANU` in
+ * `pact/stoa-coin/new-coin.pact` (evaluated against `(at "block-time"
+ * (chain-data))` on-chain — creationTime is a close client-side proxy for it).
+ *
+ * `stoa-xchain-gas`'s own guard (`pact/genesis/stoa/stoa-genesis-5.pact`)
+ * requires `gasPrice <= UC_MinimumGasPriceANU()` (an upper bound, not a
+ * floor) — combined with the chain-wide "must be >= the floor" rule, the
+ * only value that satisfies both is the floor itself. Never overpay this
+ * account; it pays minimum-priced redemptions only.
+ */
+const YIN_GENESIS_TIME_S = 1771869600; // 2026-02-23T18:00:00Z — tick 0
+const YIN_GENESIS_MIN_GAS_ANU = 10000;
+const YIN_MAX_GAS_ANU = 400000;
+const YIN_GAS_PRICE_INTERVAL_S = 10800; // 3 h per tick
+function minGasPriceAnu(creationTimeS) {
+    const elapsed = creationTimeS - YIN_GENESIS_TIME_S;
+    const ticks = elapsed <= 0 ? 0 : Math.floor(elapsed / YIN_GAS_PRICE_INTERVAL_S);
+    return Math.min(YIN_GENESIS_MIN_GAS_ANU + ticks, YIN_MAX_GAS_ANU);
+}
+/** Built by string padding, never float division — avoids exponential notation / precision loss. */
+function anuToStoaNumber(anu) {
+    return Number("0." + String(anu).padStart(12, "0"));
+}
+/**
+ * One clock read: the `creationTime` to stamp and the `gasPrice` derived
+ * FROM THAT EXACT VALUE, so the two can never disagree.
+ */
+function stoaGasMeta() {
+    const creationTime = safeCreationTime();
+    return { creationTime, gasPrice: anuToStoaNumber(minGasPriceAnu(creationTime)) };
+}
 /**
  * Get KDA balance for an account on a specific chain.
  * exists=false means the account row does not exist on that chain (not just zero balance).
@@ -72,20 +112,17 @@ export function buildCrossChainTransfer(params) {
         .setMeta({
         chainId: sourceChain,
         senderAccount: sender,
-        // v3.2.3: added `creationTime: safeCreationTime()` to close audit
-        // finding F-BUG-002. The v2.3.0 audit consolidated `safeCreationTime()`
-        // (returns `Date.now()/1000 - 30`) precisely so client-side clock drift
-        // doesn't trigger chain-side "creation time too far in the future"
-        // rejections; without this field, `@kadena/client` falls back to the
-        // raw current time and any consumer with a clock slightly ahead of
-        // node time gets sporadic submit failures. This was the lone builder
-        // in interactions/* that omitted the helper after the v2.3.0 sweep —
-        // every other setMeta block (including `buildCTransferAcross` two
-        // functions below) already includes it.
-        creationTime: safeCreationTime(),
+        // v3.2.3: `creationTime` closes audit finding F-BUG-002 — without it
+        // `@kadena/client` falls back to raw current time and a client clock
+        // slightly ahead of node time gets sporadic submit failures.
+        // `stoaGasMeta()` supplies both `creationTime` (via `safeCreationTime()`)
+        // and the `gasPrice` derived from that exact value, per the Yin Engine
+        // (see the module-level comment above) — the chain-wide minimum price
+        // rises over time, so a hardcoded `gasPrice` would eventually be
+        // rejected as underpriced.
         gasLimit: 2500,
-        gasPrice: 0.00000001,
         ttl: 28800,
+        ...stoaGasMeta(),
     })
         .setNetworkId(KADENA_NETWORK)
         .createTransaction();
@@ -95,7 +132,7 @@ export function buildCrossChainTransfer(params) {
  * Build a coin.C_TransferAcross transaction (step 0 of cross-chain transfer).
  *
  * Chain 0: Gas paid by Ouronet Gas Station (DALOS.GAS_PAYER).
- * Other chains: Gas paid by kadena-xchain-gas (unsigned).
+ * Other chains: Gas paid by stoa-xchain-gas (unsigned).
  */
 export function buildCTransferAcross(params) {
     const { sender, receiver, receiverGuard, amount, sourceChain, targetChain, senderPublicKey, gasStationPublicKey, } = params;
@@ -118,18 +155,19 @@ export function buildCTransferAcross(params) {
             .setMeta({
             chainId: "0",
             senderAccount: STOA_AUTONOMIC_OURONETGASSTATION,
-            creationTime: safeCreationTime(),
             gasLimit: 2500,
-            gasPrice: anuToStoa(GAS_PRICE_MIN_ANU),
             ttl: 28800,
+            ...stoaGasMeta(),
         })
             .setNetworkId(KADENA_NETWORK)
             .createTransaction();
     }
     else {
-        // Non-chain-0: kadena-xchain-gas pays gas.
+        // Non-chain-0: stoa-xchain-gas pays gas (StoaChain's own xchain gas
+        // station — replaces the legacy `kadena-xchain-gas` account).
         // Its guard uses coin.gas-only (no signature needed) BUT requires:
-        //   - gasPrice <= 0.00000001
+        //   - gasPrice <= UC_MinimumGasPriceANU() (the live Yin floor — an upper
+        //     bound, not a static ceiling; see the module-level comment above)
         //   - gasLimit <= 850
         // No signer needed for gas — only sender signs TRANSFER_XCHAIN cap.
         return Pact.builder
@@ -140,10 +178,10 @@ export function buildCTransferAcross(params) {
         ])
             .setMeta({
             chainId: sourceChain,
-            senderAccount: "kadena-xchain-gas",
-            gasLimit: 850, // must be ≤ 850 for kadena-xchain-gas guard
-            gasPrice: 0.00000001, // must be ≤ 0.00000001 for kadena-xchain-gas guard
+            senderAccount: "stoa-xchain-gas",
+            gasLimit: 850, // must be <= 850 for the stoa-xchain-gas guard
             ttl: 28800,
+            ...stoaGasMeta(),
         })
             .setNetworkId(KADENA_NETWORK)
             .createTransaction();
@@ -326,7 +364,7 @@ export async function pollSpvProof(requestKey, sourceChain, targetChain, maxAtte
  * Build a continuation transaction for step 2 of cross-chain transfer
  * This can be executed by anyone - no signature required from original sender
  */
-export function buildContinuationTransaction(pactId, proof, targetChain, gasPayerAccount = "kadena-xchain-gas") {
+export function buildContinuationTransaction(pactId, proof, targetChain, gasPayerAccount = "stoa-xchain-gas") {
     const transaction = Pact.builder
         .continuation({
         pactId,
@@ -337,9 +375,9 @@ export function buildContinuationTransaction(pactId, proof, targetChain, gasPaye
         .setMeta({
         chainId: targetChain,
         senderAccount: gasPayerAccount,
-        gasLimit: 850,
-        gasPrice: 0.00000001,
+        gasLimit: 850, // must be <= 850 for the stoa-xchain-gas guard
         ttl: 28800,
+        ...stoaGasMeta(),
     })
         .setNetworkId(KADENA_NETWORK)
         .createTransaction();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouronet/ouronet-core",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "Ouronet-specific business logic for the Ouronet protocol on StoaChain — interactions/* read+execute functions for the ouronet-ns Pact modules, the Codex encrypted-multi-wallet format, Ouronet protocol accounts and tokens. Depends on @stoachain/stoa-core for chain-generic infrastructure (signing, wallet, crypto, network, etc.).",
   "type": "module",
   "main": "./dist/index.js",