pyre-world-kit 2.0.8 → 2.0.10

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  */
 export type { FactionStatus, FactionTier, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, WarLoanQuote, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, MessageFactionParams, FudFactionParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult, TransactionResult, EphemeralAgent, SaidVerification, ConfirmResult, FactionSortOption, FactionStatusFilter, FactionListParams, FactionPower, AllianceCluster, RivalFaction, AgentProfile, AgentFactionPosition, WorldEventType, WorldEvent, WorldStats, RegistryProfile, RegistryWalletLink, CheckpointParams, RegisterAgentParams, LinkAgentWalletParams, UnlinkAgentWalletParams, TransferAgentAuthorityParams, } from './types';
 export { getFactions, getFaction, getMembers, getComms, getJoinQuote, getDefectQuote, getStronghold, getStrongholdForAgent, getAgentLink, getLinkedAgents, getWarChest, getWarLoan, getAllWarLoans, getMaxWarLoan, blacklistMints, isBlacklistedMint, getBlacklistedMints, launchFaction, joinFaction, directJoinFaction, defect, messageFaction, fudFaction, rally, requestWarLoan, repayWarLoan, tradeOnDex, claimSpoils, createStronghold, fundStronghold, withdrawFromStronghold, recruitAgent, exileAgent, coup, withdrawAssets, siege, ascend, raze, tithe, convertTithe, verifyAgent, confirmAction, createEphemeralAgent, getDexPool, getDexVaults, } from './actions';
-export { getFactionPower, getFactionLeaderboard, detectAlliances, getFactionRivals, getAgentProfile, getAgentFactions, getWorldFeed, getWorldStats, } from './intel';
+export { getFactionPower, getFactionLeaderboard, detectAlliances, getFactionRivals, getAgentProfile, getAgentFactions, getWorldFeed, getWorldStats, getAgentSolLamports, startVaultPnlTracker, } from './intel';
 export { isPyreMint, grindPyreMint } from './vanity';
 export { REGISTRY_PROGRAM_ID, getAgentProfilePda, getAgentWalletLinkPda, getRegistryProfile, getRegistryWalletLink, buildRegisterAgentTransaction, buildCheckpointTransaction, buildLinkAgentWalletTransaction, buildUnlinkAgentWalletTransaction, buildTransferAgentAuthorityTransaction, } from './registry';
 export { PROGRAM_ID, LAMPORTS_PER_SOL, TOKEN_MULTIPLIER, TOTAL_SUPPLY } from 'torchsdk';

package/dist/index.js

@@ -8,7 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAgentProfile = exports.getFactionRivals = exports.detectAlliances = exports.getFactionLeaderboard = exports.getFactionPower = exports.getDexVaults = exports.getDexPool = exports.createEphemeralAgent = exports.confirmAction = exports.verifyAgent = exports.convertTithe = exports.tithe = exports.raze = exports.ascend = exports.siege = exports.withdrawAssets = exports.coup = exports.exileAgent = exports.recruitAgent = exports.withdrawFromStronghold = exports.fundStronghold = exports.createStronghold = exports.claimSpoils = exports.tradeOnDex = exports.repayWarLoan = exports.requestWarLoan = exports.rally = exports.fudFaction = exports.messageFaction = exports.defect = exports.directJoinFaction = exports.joinFaction = exports.launchFaction = exports.getBlacklistedMints = exports.isBlacklistedMint = exports.blacklistMints = exports.getMaxWarLoan = exports.getAllWarLoans = exports.getWarLoan = exports.getWarChest = exports.getLinkedAgents = exports.getAgentLink = exports.getStrongholdForAgent = exports.getStronghold = exports.getDefectQuote = exports.getJoinQuote = exports.getComms = exports.getMembers = exports.getFaction = exports.getFactions = void 0;
-exports.TOTAL_SUPPLY = exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.buildTransferAgentAuthorityTransaction = exports.buildUnlinkAgentWalletTransaction = exports.buildLinkAgentWalletTransaction = exports.buildCheckpointTransaction = exports.buildRegisterAgentTransaction = exports.getRegistryWalletLink = exports.getRegistryProfile = exports.getAgentWalletLinkPda = exports.getAgentProfilePda = exports.REGISTRY_PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = exports.getWorldStats = exports.getWorldFeed = exports.getAgentFactions = void 0;
+exports.TOTAL_SUPPLY = exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.buildTransferAgentAuthorityTransaction = exports.buildUnlinkAgentWalletTransaction = exports.buildLinkAgentWalletTransaction = exports.buildCheckpointTransaction = exports.buildRegisterAgentTransaction = exports.getRegistryWalletLink = exports.getRegistryProfile = exports.getAgentWalletLinkPda = exports.getAgentProfilePda = exports.REGISTRY_PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = exports.startVaultPnlTracker = exports.getAgentSolLamports = exports.getWorldStats = exports.getWorldFeed = exports.getAgentFactions = void 0;
 // ─── Actions ───────────────────────────────────────────────────────
 var actions_1 = require("./actions");
 // Read operations
@@ -73,6 +73,8 @@ Object.defineProperty(exports, "getAgentProfile", { enumerable: true, get: funct
 Object.defineProperty(exports, "getAgentFactions", { enumerable: true, get: function () { return intel_1.getAgentFactions; } });
 Object.defineProperty(exports, "getWorldFeed", { enumerable: true, get: function () { return intel_1.getWorldFeed; } });
 Object.defineProperty(exports, "getWorldStats", { enumerable: true, get: function () { return intel_1.getWorldStats; } });
+Object.defineProperty(exports, "getAgentSolLamports", { enumerable: true, get: function () { return intel_1.getAgentSolLamports; } });
+Object.defineProperty(exports, "startVaultPnlTracker", { enumerable: true, get: function () { return intel_1.startVaultPnlTracker; } });
 // ─── Vanity ─────────────────────────────────────────────────────────
 var vanity_1 = require("./vanity");
 Object.defineProperty(exports, "isPyreMint", { enumerable: true, get: function () { return vanity_1.isPyreMint; } });

package/dist/intel.d.ts

@@ -60,3 +60,26 @@ export declare function getWorldFeed(connection: Connection, opts?: {
  * Global stats: total factions, total agents, total SOL locked.
  */
 export declare function getWorldStats(connection: Connection): Promise<WorldStats>;
+/**
+ * Get total SOL balance in lamports for an agent: vault + wallet.
+ * Checks vault first (where most SOL flows), falls back to wallet if no vault.
+ * Returns the combined balance so P&L captures all SOL movement.
+ */
+export declare function getAgentSolLamports(connection: Connection, wallet: string): Promise<number>;
+/**
+ * Start tracking P&L for a single action/tick.
+ *
+ * Snapshots wallet + vault SOL before the action. Call `finish()` after
+ * to get the diff. Covers both vault and wallet flows so no SOL is missed.
+ *
+ * Usage:
+ *   const pnl = await startVaultPnlTracker(connection, wallet)
+ *   // ... do action ...
+ *   const { spent, received } = await pnl.finish()
+ */
+export declare function startVaultPnlTracker(connection: Connection, wallet: string): Promise<{
+    finish: () => Promise<{
+        spent: number;
+        received: number;
+    }>;
+}>;

package/dist/intel.js

@@ -47,6 +47,8 @@ exports.getAgentProfile = getAgentProfile;
 exports.getAgentFactions = getAgentFactions;
 exports.getWorldFeed = getWorldFeed;
 exports.getWorldStats = getWorldStats;
+exports.getAgentSolLamports = getAgentSolLamports;
+exports.startVaultPnlTracker = startVaultPnlTracker;
 const web3_js_1 = require("@solana/web3.js");
 const torchsdk_1 = require("torchsdk");
 const mappers_1 = require("./mappers");
@@ -401,6 +403,51 @@ async function getPyreHolders(connection, mint, limit) {
     result.holders = result.holders.filter(h => !excluded.has(h.address)).slice(0, limit);
     return result;
 }
+// ─── Vault P&L ────────────────────────────────────────────────────
+/**
+ * Get total SOL balance in lamports for an agent: vault + wallet.
+ * Checks vault first (where most SOL flows), falls back to wallet if no vault.
+ * Returns the combined balance so P&L captures all SOL movement.
+ */
+async function getAgentSolLamports(connection, wallet) {
+    const walletPk = new web3_js_1.PublicKey(wallet);
+    let total = 0;
+    try {
+        total += await connection.getBalance(walletPk);
+    }
+    catch { }
+    try {
+        const vault = await (0, torchsdk_1.getVaultForWallet)(connection, wallet);
+        if (vault)
+            total += Math.round(vault.sol_balance * 1e9);
+    }
+    catch { }
+    return total;
+}
+/**
+ * Start tracking P&L for a single action/tick.
+ *
+ * Snapshots wallet + vault SOL before the action. Call `finish()` after
+ * to get the diff. Covers both vault and wallet flows so no SOL is missed.
+ *
+ * Usage:
+ *   const pnl = await startVaultPnlTracker(connection, wallet)
+ *   // ... do action ...
+ *   const { spent, received } = await pnl.finish()
+ */
+async function startVaultPnlTracker(connection, wallet) {
+    const before = await getAgentSolLamports(connection, wallet);
+    return {
+        async finish() {
+            const after = await getAgentSolLamports(connection, wallet);
+            const diff = after - before;
+            return {
+                spent: diff < 0 ? Math.abs(diff) : 0,
+                received: diff > 0 ? diff : 0,
+            };
+        },
+    };
+}
 // ─── Internal Helpers ──────────────────────────────────────────────
 function computePowerScore(t) {
     const mcWeight = 0.4;

package/dist/pyre_world.json

@@ -2,7 +2,7 @@
     "address": "2oai1EaDnFcSNskyVwSbGkUEddxxfUSsSVRokE31gRfv",
     "metadata": {
         "name": "pyre_world",
-        "version": "1.0.2",
+        "version": "1.0.3",
         "spec": "0.1.0",
         "description": "pyre.world agent registry"
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyre-world-kit",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "Agent-first faction warfare kit — game-semantic wrapper over torchsdk",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -152,6 +152,8 @@ export {
   getAgentFactions,
   getWorldFeed,
   getWorldStats,
+  getAgentSolLamports,
+  startVaultPnlTracker,
 } from './intel';
 
 // ─── Vanity ─────────────────────────────────────────────────────────

package/src/intel.ts

@@ -444,6 +444,57 @@ async function getPyreHolders(connection: Connection, mint: string, limit: numbe
   return result;
 }
 
+// ─── Vault P&L ────────────────────────────────────────────────────
+
+/**
+ * Get total SOL balance in lamports for an agent: vault + wallet.
+ * Checks vault first (where most SOL flows), falls back to wallet if no vault.
+ * Returns the combined balance so P&L captures all SOL movement.
+ */
+export async function getAgentSolLamports(
+  connection: Connection,
+  wallet: string,
+): Promise<number> {
+  const walletPk = new PublicKey(wallet);
+  let total = 0;
+  try {
+    total += await connection.getBalance(walletPk);
+  } catch {}
+  try {
+    const vault = await getVaultForWallet(connection, wallet);
+    if (vault) total += Math.round(vault.sol_balance * 1e9);
+  } catch {}
+  return total;
+}
+
+/**
+ * Start tracking P&L for a single action/tick.
+ *
+ * Snapshots wallet + vault SOL before the action. Call `finish()` after
+ * to get the diff. Covers both vault and wallet flows so no SOL is missed.
+ *
+ * Usage:
+ *   const pnl = await startVaultPnlTracker(connection, wallet)
+ *   // ... do action ...
+ *   const { spent, received } = await pnl.finish()
+ */
+export async function startVaultPnlTracker(
+  connection: Connection,
+  wallet: string,
+): Promise<{ finish: () => Promise<{ spent: number; received: number }> }> {
+  const before = await getAgentSolLamports(connection, wallet);
+  return {
+    async finish() {
+      const after = await getAgentSolLamports(connection, wallet);
+      const diff = after - before;
+      return {
+        spent: diff < 0 ? Math.abs(diff) : 0,
+        received: diff > 0 ? diff : 0,
+      };
+    },
+  };
+}
+
 // ─── Internal Helpers ──────────────────────────────────────────────
 
 function computePowerScore(t: TokenDetail): number {

package/src/pyre_world.json

@@ -2,7 +2,7 @@
   "address": "2oai1EaDnFcSNskyVwSbGkUEddxxfUSsSVRokE31gRfv",
   "metadata": {
     "name": "pyre_world",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "spec": "0.1.0",
     "description": "pyre.world agent registry"
   },