pyre-world-kit 1.0.0 → 1.0.2

package/dist/actions.d.ts

@@ -4,7 +4,7 @@
  * Thin wrappers that call torchsdk functions and map params/results
  * into game-semantic Pyre types. No new on-chain logic.
  */
-import { Connection } from '@solana/web3.js';
+import { Connection, PublicKey } from '@solana/web3.js';
 import type { BuyQuoteResult, SellQuoteResult, TransactionResult, SaidVerification, ConfirmResult } from 'torchsdk';
 import type { FactionListParams, FactionListResult, FactionDetail, MembersResult, CommsResult, Stronghold, AgentLink, WarChest, WarLoan, AllWarLoansResult, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult } from './types';
 /** List all factions with optional filtering and sorting */
@@ -13,7 +13,7 @@ export declare function getFactions(connection: Connection, params?: FactionList
 export declare function getFaction(connection: Connection, mint: string): Promise<FactionDetail>;
 /** Get faction members (top holders) */
 export declare function getMembers(connection: Connection, mint: string, limit?: number): Promise<MembersResult>;
-/** Get faction comms (trade-bundled messages) */
+/** Get faction comms (trade-bundled messages, including post-ascension DEX messages) */
 export declare function getComms(connection: Connection, mint: string, limit?: number): Promise<CommsResult>;
 /** Get a quote for joining a faction (buying tokens) */
 export declare function getJoinQuote(connection: Connection, mint: string, amountSolLamports: number): Promise<BuyQuoteResult>;
@@ -79,3 +79,5 @@ export declare function verifyAgent(wallet: string): Promise<SaidVerification>;
 export declare function confirmAction(connection: Connection, signature: string, wallet: string): Promise<ConfirmResult>;
 /** Create an ephemeral agent keypair (memory-only, zero key management) */
 export { createEphemeralAgent } from 'torchsdk';
+/** Get the Raydium pool state PDA for an ascended faction's DEX pool */
+export declare function getDexPool(mint: string): PublicKey;

package/dist/actions.js

@@ -5,6 +5,9 @@
  * Thin wrappers that call torchsdk functions and map params/results
  * into game-semantic Pyre types. No new on-chain logic.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEphemeralAgent = void 0;
 exports.getFactions = getFactions;
@@ -42,6 +45,9 @@ exports.tithe = tithe;
 exports.convertTithe = convertTithe;
 exports.verifyAgent = verifyAgent;
 exports.confirmAction = confirmAction;
+exports.getDexPool = getDexPool;
+const web3_js_1 = require("@solana/web3.js");
+const bs58_1 = __importDefault(require("bs58"));
 const torchsdk_1 = require("torchsdk");
 const mappers_1 = require("./mappers");
 const vanity_1 = require("./vanity");
@@ -67,10 +73,73 @@ async function getMembers(connection, mint, limit) {
     const result = await (0, torchsdk_1.getHolders)(connection, mint, limit);
     return (0, mappers_1.mapHoldersResult)(result);
 }
-/** Get faction comms (trade-bundled messages) */
+/** Get faction comms (trade-bundled messages, including post-ascension DEX messages) */
 async function getComms(connection, mint, limit) {
-    const result = await (0, torchsdk_1.getMessages)(connection, mint, limit);
-    return (0, mappers_1.mapMessagesResult)(result);
+    const safeLimit = Math.min(limit || 50, 100);
+    // Fetch bonding curve messages
+    const result = await (0, torchsdk_1.getMessages)(connection, mint, safeLimit);
+    const commsResult = (0, mappers_1.mapMessagesResult)(result);
+    // Also scan Raydium pool state for post-ascension DEX messages
+    try {
+        const mintPubkey = new web3_js_1.PublicKey(mint);
+        const { poolState } = (0, torchsdk_1.getRaydiumMigrationAccounts)(mintPubkey);
+        const signatures = await connection.getSignaturesForAddress(poolState, { limit: Math.min(safeLimit, 50) }, 'confirmed');
+        if (signatures.length > 0) {
+            const txs = await connection.getParsedTransactions(signatures.map(s => s.signature), { maxSupportedTransactionVersion: 0 });
+            const MEMO_PROGRAM = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';
+            const existingSigs = new Set(commsResult.comms.map(c => c.signature));
+            for (let i = 0; i < txs.length; i++) {
+                const tx = txs[i];
+                if (!tx?.meta || tx.meta.err)
+                    continue;
+                const sig = signatures[i];
+                if (existingSigs.has(sig.signature))
+                    continue;
+                // Check top-level and inner instructions for memo
+                const allInstructions = [
+                    ...tx.transaction.message.instructions,
+                    ...(tx.meta.innerInstructions || []).flatMap(inner => inner.instructions),
+                ];
+                for (const ix of allInstructions) {
+                    const programId = 'programId' in ix ? ix.programId.toString() : '';
+                    const programName = 'program' in ix ? ix.program : '';
+                    const isMemo = programId === MEMO_PROGRAM || programName === 'spl-memo';
+                    if (isMemo) {
+                        let memoText = '';
+                        if ('parsed' in ix) {
+                            memoText = typeof ix.parsed === 'string' ? ix.parsed : JSON.stringify(ix.parsed);
+                        }
+                        else if ('data' in ix && typeof ix.data === 'string') {
+                            try {
+                                memoText = new TextDecoder().decode(bs58_1.default.decode(ix.data));
+                            }
+                            catch {
+                                memoText = ix.data;
+                            }
+                        }
+                        if (memoText && memoText.trim()) {
+                            const sender = tx.transaction.message.accountKeys[0]?.pubkey?.toString() || 'Unknown';
+                            commsResult.comms.push({
+                                signature: sig.signature,
+                                memo: memoText.trim(),
+                                sender,
+                                timestamp: sig.blockTime || 0,
+                            });
+                            break;
+                        }
+                    }
+                }
+            }
+            // Re-sort by timestamp descending and trim to limit
+            commsResult.comms.sort((a, b) => b.timestamp - a.timestamp);
+            commsResult.comms = commsResult.comms.slice(0, safeLimit);
+            commsResult.total = commsResult.comms.length;
+        }
+    }
+    catch {
+        // Pool may not exist for non-ascended factions — ignore
+    }
+    return commsResult;
 }
 /** Get a quote for joining a faction (buying tokens) */
 async function getJoinQuote(connection, mint, amountSolLamports) {
@@ -195,6 +264,7 @@ async function tradeOnDex(connection, params) {
         amount_in: params.amount_in,
         minimum_amount_out: params.minimum_amount_out,
         is_buy: params.is_buy,
+        message: params.message,
     });
 }
 /** Claim spoils (protocol rewards) */
@@ -316,3 +386,8 @@ async function confirmAction(connection, signature, wallet) {
 /** Create an ephemeral agent keypair (memory-only, zero key management) */
 var torchsdk_2 = require("torchsdk");
 Object.defineProperty(exports, "createEphemeralAgent", { enumerable: true, get: function () { return torchsdk_2.createEphemeralAgent; } });
+/** Get the Raydium pool state PDA for an ascended faction's DEX pool */
+function getDexPool(mint) {
+    const { poolState } = (0, torchsdk_1.getRaydiumMigrationAccounts)(new web3_js_1.PublicKey(mint));
+    return poolState;
+}

package/dist/index.d.ts

@@ -5,8 +5,8 @@
  * This kit translates protocol primitives into faction warfare language
  * so agents think in factions, not tokens.
  */
-export type { FactionStatus, FactionTier, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, 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, WorldEvent, WorldStats, } from './types';
-export { getFactions, getFaction, getMembers, getComms, getJoinQuote, getDefectQuote, getStronghold, getStrongholdForAgent, getAgentLink, getWarChest, getWarLoan, getAllWarLoans, launchFaction, joinFaction, directJoinFaction, defect, rally, requestWarLoan, repayWarLoan, tradeOnDex, claimSpoils, createStronghold, fundStronghold, withdrawFromStronghold, recruitAgent, exileAgent, coup, withdrawAssets, siege, ascend, raze, tithe, convertTithe, verifyAgent, confirmAction, createEphemeralAgent, } from './actions';
+export type { FactionStatus, FactionTier, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, 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, } from './types';
+export { getFactions, getFaction, getMembers, getComms, getJoinQuote, getDefectQuote, getStronghold, getStrongholdForAgent, getAgentLink, getWarChest, getWarLoan, getAllWarLoans, launchFaction, joinFaction, directJoinFaction, defect, rally, requestWarLoan, repayWarLoan, tradeOnDex, claimSpoils, createStronghold, fundStronghold, withdrawFromStronghold, recruitAgent, exileAgent, coup, withdrawAssets, siege, ascend, raze, tithe, convertTithe, verifyAgent, confirmAction, createEphemeralAgent, getDexPool, } from './actions';
 export { getFactionPower, getFactionLeaderboard, detectAlliances, getFactionRivals, getAgentProfile, getAgentFactions, getWorldFeed, getWorldStats, } from './intel';
 export { isPyreMint, grindPyreMint } from './vanity';
 export { PROGRAM_ID, LAMPORTS_PER_SOL, TOKEN_MULTIPLIER, TOTAL_SUPPLY } from 'torchsdk';

package/dist/index.js

@@ -7,7 +7,8 @@
  * so agents think in factions, not tokens.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOTAL_SUPPLY = exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = exports.getWorldStats = exports.getWorldFeed = exports.getAgentFactions = exports.getAgentProfile = exports.getFactionRivals = exports.detectAlliances = exports.getFactionLeaderboard = exports.getFactionPower = 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.defect = exports.directJoinFaction = exports.joinFaction = exports.launchFaction = exports.getAllWarLoans = exports.getWarLoan = exports.getWarChest = exports.getAgentLink = exports.getStrongholdForAgent = exports.getStronghold = exports.getDefectQuote = exports.getJoinQuote = exports.getComms = exports.getMembers = exports.getFaction = exports.getFactions = void 0;
+exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = exports.getWorldStats = exports.getWorldFeed = exports.getAgentFactions = exports.getAgentProfile = exports.getFactionRivals = exports.detectAlliances = exports.getFactionLeaderboard = exports.getFactionPower = 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.defect = exports.directJoinFaction = exports.joinFaction = exports.launchFaction = exports.getAllWarLoans = exports.getWarLoan = exports.getWarChest = exports.getAgentLink = exports.getStrongholdForAgent = exports.getStronghold = exports.getDefectQuote = exports.getJoinQuote = exports.getComms = exports.getMembers = exports.getFaction = exports.getFactions = void 0;
+exports.TOTAL_SUPPLY = void 0;
 // ─── Actions ───────────────────────────────────────────────────────
 var actions_1 = require("./actions");
 // Read operations
@@ -52,6 +53,7 @@ Object.defineProperty(exports, "verifyAgent", { enumerable: true, get: function
 Object.defineProperty(exports, "confirmAction", { enumerable: true, get: function () { return actions_1.confirmAction; } });
 // Utility
 Object.defineProperty(exports, "createEphemeralAgent", { enumerable: true, get: function () { return actions_1.createEphemeralAgent; } });
+Object.defineProperty(exports, "getDexPool", { enumerable: true, get: function () { return actions_1.getDexPool; } });
 // ─── Intel ─────────────────────────────────────────────────────────
 var intel_1 = require("./intel");
 Object.defineProperty(exports, "getFactionPower", { enumerable: true, get: function () { return intel_1.getFactionPower; } });

package/dist/types.d.ts

@@ -217,6 +217,8 @@ export interface TradeOnDexParams {
     amount_in: number;
     minimum_amount_out: number;
     is_buy: boolean;
+    /** Optional message bundled as SPL Memo instruction (max 500 chars) */
+    message?: string;
 }
 export interface ClaimSpoilsParams {
     agent: string;
@@ -334,8 +336,10 @@ export interface AgentFactionPosition {
     percentage: number;
     value_sol: number;
 }
+/** Action types for world events and stage feed */
+export type WorldEventType = 'launch' | 'join' | 'reinforce' | 'defect' | 'rally' | 'ascend' | 'raze' | 'messaged' | 'siege' | 'tithe' | 'war_loan' | 'repay_loan';
 export interface WorldEvent {
-    type: 'launch' | 'join' | 'defect' | 'rally' | 'ascend' | 'raze';
+    type: WorldEventType;
     faction_mint: string;
     faction_name: string;
     agent?: string;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "pyre-world-kit",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Agent-first faction warfare kit — game-semantic wrapper over torchsdk",
-    "main": "dist/index.js",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
@@ -11,15 +11,16 @@
     "test:devnet": "npx tsx tests/test_devnet_e2e.ts"
   },
   "dependencies": {
-    "torchsdk": "^3.7.30",
-    "@solana/web3.js": "^1.98.4",
+    "@coral-xyz/anchor": "^0.32.1",
     "@solana/spl-token": "^0.4.6",
-    "@coral-xyz/anchor": "^0.32.1"
+    "@solana/web3.js": "^1.98.4",
+    "bs58": "^6.0.0",
+    "torchsdk": "^3.7.32"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "typescript": "^5.9.3",
-    "tsx": "^4.19.4"
+    "tsx": "^4.19.4",
+    "typescript": "^5.9.3"
   },
   "packageManager": "pnpm@9.10.0+sha512.73a29afa36a0d092ece5271de5177ecbf8318d454ecd701343131b8ebc0c1a91c487da46ab77c8e596d6acf1461e3594ced4becedf8921b074fbd8653ed7051c"
 }

package/src/actions.ts

@@ -5,7 +5,8 @@
  * into game-semantic Pyre types. No new on-chain logic.
  */
 
-import { Connection } from '@solana/web3.js';
+import { Connection, PublicKey } from '@solana/web3.js';
+import bs58 from 'bs58';
 import {
   // Read operations
   getTokens,
@@ -20,6 +21,8 @@ import {
   getLendingInfo,
   getLoanPosition,
   getAllLoanPositions,
+  // PDA derivation
+  getRaydiumMigrationAccounts,
   // Transaction builders
   buildBuyTransaction,
   buildDirectBuyTransaction,
@@ -138,14 +141,92 @@ export async function getMembers(
   return mapHoldersResult(result);
 }
 
-/** Get faction comms (trade-bundled messages) */
+/** Get faction comms (trade-bundled messages, including post-ascension DEX messages) */
 export async function getComms(
   connection: Connection,
   mint: string,
   limit?: number,
 ): Promise<CommsResult> {
-  const result = await getMessages(connection, mint, limit);
-  return mapMessagesResult(result);
+  const safeLimit = Math.min(limit || 50, 100);
+
+  // Fetch bonding curve messages
+  const result = await getMessages(connection, mint, safeLimit);
+  const commsResult = mapMessagesResult(result);
+
+  // Also scan Raydium pool state for post-ascension DEX messages
+  try {
+    const mintPubkey = new PublicKey(mint);
+    const { poolState } = getRaydiumMigrationAccounts(mintPubkey);
+
+    const signatures = await connection.getSignaturesForAddress(
+      poolState,
+      { limit: Math.min(safeLimit, 50) },
+      'confirmed',
+    );
+
+    if (signatures.length > 0) {
+      const txs = await connection.getParsedTransactions(
+        signatures.map(s => s.signature),
+        { maxSupportedTransactionVersion: 0 },
+      );
+
+      const MEMO_PROGRAM = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';
+      const existingSigs = new Set(commsResult.comms.map(c => c.signature));
+
+      for (let i = 0; i < txs.length; i++) {
+        const tx = txs[i];
+        if (!tx?.meta || tx.meta.err) continue;
+
+        const sig = signatures[i];
+        if (existingSigs.has(sig.signature)) continue;
+
+        // Check top-level and inner instructions for memo
+        const allInstructions = [
+          ...tx.transaction.message.instructions,
+          ...(tx.meta.innerInstructions || []).flatMap(inner => inner.instructions),
+        ];
+
+        for (const ix of allInstructions) {
+          const programId = 'programId' in ix ? ix.programId.toString() : '';
+          const programName = 'program' in ix ? (ix as { program: string }).program : '';
+          const isMemo = programId === MEMO_PROGRAM || programName === 'spl-memo';
+
+          if (isMemo) {
+            let memoText = '';
+            if ('parsed' in ix) {
+              memoText = typeof ix.parsed === 'string' ? ix.parsed : JSON.stringify(ix.parsed);
+            } else if ('data' in ix && typeof ix.data === 'string') {
+              try {
+                memoText = new TextDecoder().decode(bs58.decode(ix.data));
+              } catch {
+                memoText = ix.data;
+              }
+            }
+
+            if (memoText && memoText.trim()) {
+              const sender = tx.transaction.message.accountKeys[0]?.pubkey?.toString() || 'Unknown';
+              commsResult.comms.push({
+                signature: sig.signature,
+                memo: memoText.trim(),
+                sender,
+                timestamp: sig.blockTime || 0,
+              });
+              break;
+            }
+          }
+        }
+      }
+
+      // Re-sort by timestamp descending and trim to limit
+      commsResult.comms.sort((a, b) => b.timestamp - a.timestamp);
+      commsResult.comms = commsResult.comms.slice(0, safeLimit);
+      commsResult.total = commsResult.comms.length;
+    }
+  } catch {
+    // Pool may not exist for non-ascended factions — ignore
+  }
+
+  return commsResult;
 }
 
 /** Get a quote for joining a faction (buying tokens) */
@@ -338,6 +419,7 @@ export async function tradeOnDex(
     amount_in: params.amount_in,
     minimum_amount_out: params.minimum_amount_out,
     is_buy: params.is_buy,
+    message: params.message,
   });
 }
 
@@ -521,3 +603,9 @@ export async function confirmAction(
 
 /** Create an ephemeral agent keypair (memory-only, zero key management) */
 export { createEphemeralAgent } from 'torchsdk';
+
+/** Get the Raydium pool state PDA for an ascended faction's DEX pool */
+export function getDexPool(mint: string): PublicKey {
+  const { poolState } = getRaydiumMigrationAccounts(new PublicKey(mint));
+  return poolState;
+}

package/src/index.ts

@@ -68,6 +68,7 @@ export type {
   RivalFaction,
   AgentProfile,
   AgentFactionPosition,
+  WorldEventType,
   WorldEvent,
   WorldStats,
 } from './types';
@@ -117,6 +118,7 @@ export {
   confirmAction,
   // Utility
   createEphemeralAgent,
+  getDexPool,
 } from './actions';
 
 // ─── Intel ─────────────────────────────────────────────────────────

package/src/intel.ts

@@ -5,7 +5,7 @@
  * strategic intelligence. Agents use these to reason about the world.
  */
 
-import { Connection } from '@solana/web3.js';
+import { Connection, PublicKey } from '@solana/web3.js';
 import {
   getTokens,
   getToken,
@@ -13,6 +13,7 @@ import {
   getMessages,
   getVaultForWallet,
   verifySaid,
+  PROGRAM_ID,
 } from 'torchsdk';
 import type { TokenDetail, TokenSummary } from 'torchsdk';
 

package/src/types.ts

@@ -259,6 +259,8 @@ export interface TradeOnDexParams {
   amount_in: number;
   minimum_amount_out: number;
   is_buy: boolean;
+  /** Optional message bundled as SPL Memo instruction (max 500 chars) */
+  message?: string;
 }
 
 export interface ClaimSpoilsParams {
@@ -405,8 +407,14 @@ export interface AgentFactionPosition {
   value_sol: number;
 }
 
+/** Action types for world events and stage feed */
+export type WorldEventType =
+  | 'launch' | 'join' | 'reinforce' | 'defect' | 'rally'
+  | 'ascend' | 'raze' | 'messaged'
+  | 'siege' | 'tithe' | 'war_loan' | 'repay_loan';
+
 export interface WorldEvent {
-  type: 'launch' | 'join' | 'defect' | 'rally' | 'ascend' | 'raze';
+  type: WorldEventType;
   faction_mint: string;
   faction_name: string;
   agent?: string;