@hardkas/localnet 0.7.9-alpha → 0.7.10-alpha

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _hardkas_artifacts from '@hardkas/artifacts';
 import { HardkasArtifactBase, Snapshot as Snapshot$1, TxPlan, ARTIFACT_SCHEMAS, TxReceipt } from '@hardkas/artifacts';
 import * as _hardkas_simulator from '@hardkas/simulator';
 import { ExecutionMode, NetworkId, RuntimeContext } from '@hardkas/core';
-import { KaspaRpcClient } from '@hardkas/kaspa-rpc';
+import { KaspaRpcClient, KaspaNodeInfo, KaspaRpcHealth, KaspaAddressBalance, KaspaRpcUtxo, KaspaSubmitTransactionResult, MempoolEntry, BlockDagInfo, ServerInfo } from '@hardkas/kaspa-rpc';
 
 interface HardkasAccount {
     readonly name: string;
@@ -372,7 +372,7 @@ declare function moveSink(dag: SimulatedDag, newSinkId: string, txProvider: (txI
     inputs: string[];
 } | undefined): SimulatedDag;
 /**
- * Deterministic Conflict Resolution (Approximation for 0.7.7-alpha)
+ * Deterministic Conflict Resolution (Approximation for 0.7.10-alpha)
  * Priority:
  * 1. sink ancestry priority (is part of selectedPathToSink?)
  * 2. deterministic block order (daaScore then block ID)
@@ -413,4 +413,21 @@ interface ForkOptions {
 }
 declare function forkFromNetwork(rpc: KaspaRpcClient, opts: ForkOptions): Promise<LocalnetState>;
 
-export { type CreateInitialStateOptions, DUST_LIMIT_SOMPI, type ForkOptions, type FundAddressInput, type HardkasAccount, type HardkasDevnet, type LocalnetAccount, type LocalnetState, type LocalnetUtxo, type ReplayInvariantResult, type ReplayVerificationReport, type SimulatedBlock, type SimulatedDag, SimulatedKaspaChain, type SimulatedPaymentInput, type SimulatedReplaySummary, type SimulatedUtxo, type SimulationResult, type Snapshot, type SnapshotRestoreResult, type SnapshotVerificationResult, type StateTransition, type StoredSimulatedTxReceipt, type StoredSimulatedTxTrace, type StoredTraceEvent, addSimulatedBlock, applySimulatedPayment, applySimulatedPlan, calculateAccountsHash, calculateStateHash, calculateUtxoSetHash, createDeterministicAccounts, createInitialLocalnetState, createLocalnetSnapshot, createSimulatedDag, findBestTip, forkFromNetwork, fundAddress, getAccountBalanceSompi, getAddressBalanceSompi, getDagColoring, getDefaultLocalnetDir, getDefaultLocalnetStatePath, getDefaultReceiptsDir, getDefaultTracesDir, getReceiptPath, getSelectedChain, getSimulatedReplaySummary, getSpendableUtxos, getTracePath, listSimulatedReceipts, listSimulatedTraces, loadLocalnetState, loadOrCreateLocalnetState, loadSimulatedReceipt, loadSimulatedTrace, moveSink, reconstructStateAtDaa, resetLocalnetState, resolveAccountAddress, resolveAccountAddressFromState, resolveConflictsDeterministically, restoreLocalnetSnapshot, saveLocalnetState, saveSimulatedReceipt, saveSimulatedTrace, startSimulatedDevnet, verifyReplay, verifySnapshot };
+declare class LocalnetSimulatedProvider implements KaspaRpcClient {
+    private readonly workspacePath;
+    constructor(workspacePath: string);
+    getInfo(): Promise<KaspaNodeInfo>;
+    healthCheck(): Promise<KaspaRpcHealth>;
+    getBalanceByAddress(address: string): Promise<KaspaAddressBalance>;
+    getBalancesByAddresses(addresses: string[]): Promise<KaspaAddressBalance[]>;
+    getUtxosByAddress(address: string): Promise<KaspaRpcUtxo[]>;
+    getUtxosByAddresses(addresses: string[]): Promise<KaspaRpcUtxo[]>;
+    submitTransaction(rawTransaction: string): Promise<KaspaSubmitTransactionResult>;
+    getMempoolEntry(txId: string): Promise<MempoolEntry | null>;
+    getTransaction(txId: string): Promise<unknown | null>;
+    getBlockDagInfo(): Promise<BlockDagInfo>;
+    getServerInfo(): Promise<ServerInfo>;
+    close(): Promise<void>;
+}
+
+export { type CreateInitialStateOptions, DUST_LIMIT_SOMPI, type ForkOptions, type FundAddressInput, type HardkasAccount, type HardkasDevnet, type LocalnetAccount, LocalnetSimulatedProvider, type LocalnetState, type LocalnetUtxo, type ReplayInvariantResult, type ReplayVerificationReport, type SimulatedBlock, type SimulatedDag, SimulatedKaspaChain, type SimulatedPaymentInput, type SimulatedReplaySummary, type SimulatedUtxo, type SimulationResult, type Snapshot, type SnapshotRestoreResult, type SnapshotVerificationResult, type StateTransition, type StoredSimulatedTxReceipt, type StoredSimulatedTxTrace, type StoredTraceEvent, addSimulatedBlock, applySimulatedPayment, applySimulatedPlan, calculateAccountsHash, calculateStateHash, calculateUtxoSetHash, createDeterministicAccounts, createInitialLocalnetState, createLocalnetSnapshot, createSimulatedDag, findBestTip, forkFromNetwork, fundAddress, getAccountBalanceSompi, getAddressBalanceSompi, getDagColoring, getDefaultLocalnetDir, getDefaultLocalnetStatePath, getDefaultReceiptsDir, getDefaultTracesDir, getReceiptPath, getSelectedChain, getSimulatedReplaySummary, getSpendableUtxos, getTracePath, listSimulatedReceipts, listSimulatedTraces, loadLocalnetState, loadOrCreateLocalnetState, loadSimulatedReceipt, loadSimulatedTrace, moveSink, reconstructStateAtDaa, resetLocalnetState, resolveAccountAddress, resolveAccountAddressFromState, resolveConflictsDeterministically, restoreLocalnetSnapshot, saveLocalnetState, saveSimulatedReceipt, saveSimulatedTrace, startSimulatedDevnet, verifyReplay, verifySnapshot };

package/dist/index.js

@@ -1158,8 +1158,109 @@ async function forkFromNetwork(rpc, opts) {
   };
   return state;
 }
+
+// src/provider.ts
+var LocalnetSimulatedProvider = class {
+  constructor(workspacePath) {
+    this.workspacePath = workspacePath;
+  }
+  workspacePath;
+  async getInfo() {
+    return {
+      serverVersion: "hardkas-simulated-1.0.0",
+      isSynced: true,
+      isUtxoIndexed: true,
+      p2pId: "simulated-node-1"
+    };
+  }
+  async healthCheck() {
+    return {
+      endpoint: "simulated://local",
+      status: "healthy",
+      latencyMs: 1,
+      circuitState: "closed",
+      stale: false,
+      info: await this.getInfo(),
+      reachable: true
+    };
+  }
+  async getBalanceByAddress(address) {
+    const statePath = getDefaultLocalnetStatePath(this.workspacePath);
+    const state = await loadLocalnetState(statePath);
+    if (!state) {
+      return { address, balanceSompi: 0n };
+    }
+    const balance = getAddressBalanceSompi(state, address);
+    return {
+      address,
+      balanceSompi: balance
+    };
+  }
+  async getBalancesByAddresses(addresses) {
+    const statePath = getDefaultLocalnetStatePath(this.workspacePath);
+    const state = await loadLocalnetState(statePath);
+    if (!state) {
+      return addresses.map((address) => ({ address, balanceSompi: 0n }));
+    }
+    return addresses.map((address) => ({
+      address,
+      balanceSompi: getAddressBalanceSompi(state, address)
+    }));
+  }
+  async getUtxosByAddress(address) {
+    const statePath = getDefaultLocalnetStatePath(this.workspacePath);
+    const state = await loadLocalnetState(statePath);
+    if (!state) return [];
+    const utxos = getSpendableUtxos(state, address);
+    return utxos.map((u) => ({
+      address: u.address,
+      amountSompi: BigInt(u.amountSompi),
+      outpoint: {
+        transactionId: u.id.split(":")[1] || "unknown",
+        index: Number(u.id.split(":")[2]) || 0
+      },
+      blockDaaScore: u.createdAtDaaScore,
+      isCoinbase: false,
+      scriptPublicKey: ""
+    }));
+  }
+  async getUtxosByAddresses(addresses) {
+    const allUtxos = [];
+    for (const address of addresses) {
+      const utxos = await this.getUtxosByAddress(address);
+      allUtxos.push(...utxos);
+    }
+    return allUtxos;
+  }
+  async submitTransaction(rawTransaction) {
+    throw new Error("submitTransaction not implemented on SimulatedProvider. Use sdk.tx.simulate instead.");
+  }
+  async getMempoolEntry(txId) {
+    return null;
+  }
+  async getTransaction(txId) {
+    return null;
+  }
+  async getBlockDagInfo() {
+    return {
+      networkId: "simnet",
+      virtualDaaScore: 1n,
+      tipHashes: []
+    };
+  }
+  async getServerInfo() {
+    return {
+      serverVersion: "simulated",
+      networkId: "simnet",
+      isSynced: true
+    };
+  }
+  async close() {
+  }
+};
 export {
   DUST_LIMIT_SOMPI,
+  LocalnetSimulatedProvider,
   SimulatedKaspaChain,
   addSimulatedBlock,
   applySimulatedPayment,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/localnet",
-  "version": "0.7.9-alpha",
+  "version": "0.7.10-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,12 +8,12 @@
     ".": "./dist/index.js"
   },
   "dependencies": {
-    "@hardkas/artifacts": "0.7.9-alpha",
-    "@hardkas/core": "0.7.9-alpha",
-    "@hardkas/simulator": "0.7.9-alpha",
-    "@hardkas/kaspa-rpc": "0.7.9-alpha",
-    "@hardkas/tx-builder": "0.7.9-alpha",
-    "@hardkas/query": "0.7.9-alpha"
+    "@hardkas/artifacts": "0.7.10-alpha",
+    "@hardkas/core": "0.7.10-alpha",
+    "@hardkas/kaspa-rpc": "0.7.10-alpha",
+    "@hardkas/query": "0.7.10-alpha",
+    "@hardkas/simulator": "0.7.10-alpha",
+    "@hardkas/tx-builder": "0.7.10-alpha"
   },
   "devDependencies": {
     "fast-check": "^4.8.0",