pyre-world-kit 2.0.12 → 3.0.1

package/dist/types/state.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.ts

@@ -9,10 +9,8 @@ import type { Transaction, Keypair, PublicKey } from '@solana/web3.js';
 import type { TokenSortOption, TransactionResult, CreateTokenResult, SaidVerification, ConfirmResult, EphemeralAgent } from 'torchsdk';
 /** Faction lifecycle: rising (bonding) → ready (complete) → ascended (migrated) → razed (reclaimed) */
 export type FactionStatus = 'rising' | 'ready' | 'ascended' | 'razed';
-/** Faction tier based on SOL target: ember (spark) → blaze (flame) → inferno (torch) */
-export type FactionTier = 'ember' | 'blaze' | 'inferno';
 /** Governance strategy: scorched_earth (burn tokens) or fortify (return to treasury lock) */
-export type Strategy = 'scorched_earth' | 'fortify';
+export type Strategy = 'smelt' | 'fortify';
 /** Agent loan health status */
 export type AgentHealth = 'healthy' | 'at_risk' | 'liquidatable' | 'none';
 /** Summary view of a faction (wraps TokenSummary) */
@@ -21,7 +19,6 @@ export interface FactionSummary {
     name: string;
     symbol: string;
     status: FactionStatus;
-    tier: FactionTier;
     price_sol: number;
     market_cap_sol: number;
     progress_percent: number;
@@ -37,7 +34,6 @@ export interface FactionDetail {
     description?: string;
     image?: string;
     status: FactionStatus;
-    tier: FactionTier;
     price_sol: number;
     price_usd?: number;
     market_cap_sol: number;
@@ -165,26 +161,20 @@ export interface JoinFactionParams {
     mint: string;
     agent: string;
     amount_sol: number;
-    slippage_bps?: number;
-    strategy?: Strategy;
-    message?: string;
     stronghold: string;
-}
-export interface DirectJoinFactionParams {
-    mint: string;
-    agent: string;
-    amount_sol: number;
     slippage_bps?: number;
     strategy?: Strategy;
     message?: string;
+    ascended?: boolean;
 }
 export interface DefectParams {
     mint: string;
     agent: string;
     amount_tokens: number;
+    stronghold: string;
     slippage_bps?: number;
     message?: string;
-    stronghold?: string;
+    ascended?: boolean;
 }
 /** "Said in" — micro buy + message (costs 0.001 SOL) */
 export interface MessageFactionParams {
@@ -213,19 +203,19 @@ export interface RequestWarLoanParams {
     borrower: string;
     collateral_amount: number;
     sol_to_borrow: number;
-    stronghold?: string;
+    stronghold: string;
 }
 export interface RepayWarLoanParams {
     mint: string;
     borrower: string;
     sol_amount: number;
-    stronghold?: string;
+    stronghold: string;
 }
 export interface SiegeParams {
     mint: string;
     liquidator: string;
     borrower: string;
-    stronghold?: string;
+    stronghold: string;
 }
 export interface TradeOnDexParams {
     mint: string;
@@ -285,11 +275,6 @@ export interface RazeParams {
     mint: string;
 }
 export interface TitheParams {
-    mint: string;
-    payer: string;
-    sources?: string[];
-}
-export interface ConvertTitheParams {
     mint: string;
     payer: string;
     minimum_amount_out?: number;
@@ -297,7 +282,7 @@ export interface ConvertTitheParams {
     sources?: string[];
 }
 /** Re-export base result types with game names */
-export type { TransactionResult, CreateTokenResult, EphemeralAgent, SaidVerification, ConfirmResult };
+export type { TransactionResult, CreateTokenResult, EphemeralAgent, SaidVerification, ConfirmResult, };
 export interface JoinFactionResult extends TransactionResult {
     migrationTransaction?: Transaction;
 }
@@ -359,7 +344,6 @@ export interface AgentProfile {
     stronghold: Stronghold | null;
     factions_joined: AgentFactionPosition[];
     factions_founded: string[];
-    said_verification: SaidVerification | null;
     total_value_sol: number;
 }
 export interface AgentFactionPosition {

package/dist/util.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pyre Kit Actions
+ *
+ * Thin wrappers that call torchsdk functions and map params/results
+ * into game-semantic Pyre types. No new on-chain logic.
+ */
+import { PublicKey } from '@solana/web3.js';
+import { Intel } from './types/intel.types';
+/** Add mints to the blacklist (call at startup with old mints) */
+export declare function blacklistMints(mints: string[]): void;
+/** Check if a mint is blacklisted */
+export declare function isBlacklistedMint(mint: string): boolean;
+/** Get all blacklisted mints */
+export declare function getBlacklistedMints(): string[];
+/** 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;
+/** Get Raydium pool vault addresses for an ascended faction */
+export declare function getDexVaults(mint: string): {
+    solVault: string;
+    tokenVault: string;
+};
+export declare const startVaultPnlTracker: (intel: Intel, wallet: string) => Promise<{
+    finish: () => Promise<{
+        spent: number;
+        received: number;
+    }>;
+}>;

package/dist/util.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Pyre Kit Actions
+ *
+ * Thin wrappers that call torchsdk functions and map params/results
+ * into game-semantic Pyre types. No new on-chain logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startVaultPnlTracker = exports.createEphemeralAgent = void 0;
+exports.blacklistMints = blacklistMints;
+exports.isBlacklistedMint = isBlacklistedMint;
+exports.getBlacklistedMints = getBlacklistedMints;
+exports.getDexPool = getDexPool;
+exports.getDexVaults = getDexVaults;
+const web3_js_1 = require("@solana/web3.js");
+const torchsdk_1 = require("torchsdk");
+// ─── Blacklist ──────────────────────────────────────────────────────
+// Mints from previous swarm runs. Agents should skip these and only
+// interact with freshly launched factions.
+const DEFAULT_BLACKLIST = [
+    'E1SgYPW6JXhw5BabrvJkr6L2PyvfFenYaoCTePazyNpy',
+    '6jWsyDC87RmfrZZRjuxSAxvUxE665HGZwZ2Z8j5z9epy',
+    '6J8PLgFxHb98cNURP2Yt2SKwgnUeEXpN6Us2kxaMz1py',
+    '5A297UyPQstxWpJyydDnFvn2zN8whCEYdqvnfB5bF9py',
+    '8XdWfSKLJusAcRrYzK3bWJ7dy46AkbU8qxF3B55uSfpy',
+    '7ZYrKcJbFFbG36keCYRvfc1j1HScQmJW1zRV3wVVD4py',
+    'ERQPyG2oqx5bdyuY2Nnm5ZbZY2zcB46TfUxqpzYWH5py',
+    'JCvpK3kTnh2EdQG71mqE8ZXcvzLU5EJNG5vgGZme4wpy',
+    '9RDFkGSjKpjHtXZ25uuug2MN5P7oSjzkLg16HcrKy3py',
+    '2kWcX1ZetV4jUtBPbKKk265q4gS4nuut2kc1MbaZDfpy',
+    '3r9FnQim6GToR7NkY5om8igUNu7gfpq5fk2qtv3bV5py',
+    '2498F79s1Ghyj3J4VhV1qy5hhznnM53ZwzTXM9iscopy',
+    '5VpotyDyc8QKKqLuzu8pfhtEa9gsRG1ww58DbqJUgTpy',
+    'GXi1opahTkavPfAqfUhkoUJRBjPoAmAMVW87kdbDwNpy',
+    'GKFAokGiyhXGXxUPgwQEo8fE5nBjRdJcVX6LVj7SgPpy',
+    'EKFVwfNk1xzqhpyFJSMNw8KDcLRemvqxiGoSyfRtBspy',
+    'GsZLHVt3mTwus5krUcifBWS52xMQSuXSy3RpPhEFtvpy',
+    '9azKjXnt2w4RB5ykVcyaicWSssmxoapZ9SSQLMZc4Epy',
+    'BaLwryyMrqhtsMrELkrTSdWF9UYuNdjW4413hrQqbtpy',
+    '5p9ibszMVe79mm95M8uubS6WttXem2xZfh3mWmBdvUpy',
+    'CTvoAmTggJcBTnbxcfy91Y1c6t6fU5xq3SRtYh3TgEpy',
+    '2kqVCdQS9KSv2kxLiytGZfcLsx5xwKQT6rHTg4V18hpy',
+    'zV7XZcvY8DVk4scKUiw7GGN4L3eBPSXuD7Q1NPxfspy',
+    '3UhzKfdU1wgnEN2VCykRURw88qVVqeu3ejRkUnjmhRpy',
+    'FRaS3dAdr1zo6u811XBVGUp9K2mSdQ2yG8qW4qP5hapy',
+    '4NHzWVP7hzZhd9LhTrbyxzsSnT8EmNSYVP1DpAKXHYpy',
+    'Yt2rdfp6uzS7L52df3LPmetLoy3GvKChYJ4Lmvk6gpy',
+    '9Ejju29KHPWMpda4WpFsJ6ZDHVUqNWyMZHteEisgw9py',
+    '2zPC4A7WR2cMNDfBzERp49fEbTBCyqXPKhcrgz3hWcpy',
+    '7jBAriydb1qRy7Wg4WAz8woHP4pVxZJSnF7vw95tVQpy',
+    'HvPWKuMFpG3zAdkPMbaadyo78VoJbAMtpXaBYMK1Aqpy',
+    'GyNw9bkqz2rhR66Xx7P4p11PFBrjPi2r6XoCg5gPAdpy',
+    '6HveNEes9xtkkchb76JgjWWQ61sbXjESy2vr3A7Maipy',
+    '8E3GETvTkTTaCLpzkyHJTnuNMfmGvzUEgAYnurZuLZpy',
+    'AeApaJqppwjW9S2KeZGPZpmg1kAdxZHkFRnXPZc8Kjpy',
+    '8FfteyAMQm96upu4w6cJvE5T8RcMKRf5keJMdXbukXpy',
+    'BrEj2Q9XE13WesRU1u8USiprv2DkpBcJfaqQeqQ6grpy',
+    'Dtki37mAB3DiTW1bp8LnZQyv54UuC68Yo5pGZkPdVSpy',
+    '77UzTntZ7ThyXhN4hVvSx7m6tjit8uCw6U2LVQHPSqpy',
+    'ASV9kiC6vEpZy3X7xVExuyG257KHKd3Hutbji8AVRUpy',
+    'Fc1V6KcxSriJkUNeDLqz8w5Sm4mp1s8gxornZVLcHEpy',
+    'FEizyHEUoYenqfpF87kqiGnq3w1R2TReodEfsnTrrfpy',
+    'DmwgcVHoJxKeRiij5LtedY9LWDpqoqa3hGfUyVgBkgpy',
+    'GUGz1Em5KZ57aKFqEBSd4Y4Vb6WxBd3H2b16fPCC6upy',
+    '6ZWY3Bau5zw1j7vMQQ1czSw4rjBJrExHQ8Renor2vLpy',
+    // wave 3
+    '4LyPhwUCZNLEp45RsGWdwtkX5tb3wmwydBKEu1V7fxpy',
+    'FYw8FZKzG6vVweUMQgSXBrY9ViHgquWyN4x5QthaK3py',
+    'DhFhRRpRMkPi2Vz3kErZWHNmWqxgQm5YwXT5pFpgVKpy',
+    '6GLqPmACtuDi4LcMtVpFK43sYkG8yVouYiDfdfBSSVpy',
+    '8YYYewvvCTGPZ2UddgrD6oWUZD7CYXe3DBbA9GBkapy',
+    'FpQT2uDi3oxEpnayKHAUCcWXVhtDaZCb85e7nZzoCUpy',
+    '5EWX6grTtA46FQUHGC1kogCW3CsnVfXNvVgrYVtwvRpy',
+    '8HSvBFkr6gu9qtbMKcTAZSjzkj4Ag1d1wkdiaMDHHapy',
+    '2hgo2kdtNNQGNuvfEPSfydWDqfhSwfbFTzgeVb758wpy',
+    'DKvaEayFig3RHQ9rXHnCKBjvMnJCstzuBmSe77Ybf6py',
+    'Cws3YSPxWYxzrEEfguLi3p13ea2vPNi42mjJwwSMTTpy',
+    'GodcBg2dLzrypiYH5Aqo2bTJ7KiZa5G5XSDwNQ74iYpy',
+    '46tUp7tMEhpLeenPXQwvzP8H8V5M4F63vi4M9k4bbbpy',
+    'a5iH2Soh5c8X81vTVbKZq7A7yPckhFdN1amv1Q2tapy',
+    '2zTGWtQeJ5GtdHu888QikPzKkyHJPWVFYtoQjNeJJ7py',
+    'HNnpL7z1GKsXuxaEHs2a52zW7tTUjU4dZnrSEf8ZsMpy',
+    'EASit9Yrj1SBg6xchFxDSwVV9Rz11RKdDpB4tcNsekpy',
+    'F7VcdtqsXV6nkDL3yk6esUBu9qGvka4EY9XNTQ7PmZpy',
+    '3huHC9Co5dy5Z5U6H8Vf7aVTcuukpKeUr8rDQx8s5Zpy',
+    '97ymhwybP8Jh45VcYBJY1pwQ5xkPLX15u7Tg3P7TG7py',
+    '92fMEzcYdcoEXX8A5T8i8vfz2S96P39abzoXXuBghfpy',
+    '2ZeQsU13WjgX2152qV3wyzxURjLg7GwfXznAiA99Jjpy',
+    'FuUHck8jqaXxGiTuLym4gYXJQrueyEsgd8AMUQx2fMpy',
+    'trTuaGATQZwUeYkYTeyJfQnGGnKRvAriAZRgBWg7Epy',
+    'HEhemzeszztaFzFYR9DjpNwdhghVDD1y7cHxP93EPZpy',
+    'obuf6MkL1ev6WuUDDjH3bq2q6Ryr6MBNMRsA6dEW4py',
+    '76ruUbqBpqSKsysoPesDrpaLsDSahWWphQmXrswiLbpy',
+    '4ci4scCevt5tXCxkGr5xHoWyaeQY1dahp5nFsTnfYApy',
+    'shzuPKgqedBxJmxdrRyWAtajG3hSNyLr72SufvmEvpy',
+    // wave 4 (devnet cleanup)
+    'ZkprRY78cmfSmjMvDmgb4rWRxnxNrQYpF8chejRt3py',
+    '4BFfCqG4L6bsS2tEZTpgQPJjsSqqLPQaxuaWMJcaRjpy',
+    '5xRA2q9oHjoxN1XgqMTZW3aRBgGppcLCCbLBURepXApy',
+];
+const BLACKLISTED_MINTS = new Set(DEFAULT_BLACKLIST);
+/** Add mints to the blacklist (call at startup with old mints) */
+function blacklistMints(mints) {
+    for (const m of mints)
+        BLACKLISTED_MINTS.add(m);
+}
+/** Check if a mint is blacklisted */
+function isBlacklistedMint(mint) {
+    return BLACKLISTED_MINTS.has(mint);
+}
+/** Get all blacklisted mints */
+function getBlacklistedMints() {
+    return Array.from(BLACKLISTED_MINTS);
+}
+/** 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;
+}
+/** Get Raydium pool vault addresses for an ascended faction */
+function getDexVaults(mint) {
+    const accts = (0, torchsdk_1.getRaydiumMigrationAccounts)(new web3_js_1.PublicKey(mint));
+    return {
+        solVault: (accts.isWsolToken0 ? accts.token0Vault : accts.token1Vault).toString(),
+        tokenVault: (accts.isWsolToken0 ? accts.token1Vault : accts.token0Vault).toString(),
+    };
+}
+const startVaultPnlTracker = async (intel, wallet) => {
+    const before = await intel.getAgentSolLamports(wallet);
+    return {
+        async finish() {
+            const after = await intel.getAgentSolLamports(wallet);
+            const diff = after - before;
+            return {
+                spent: diff < 0 ? Math.abs(diff) : 0,
+                received: diff > 0 ? diff : 0,
+            };
+        },
+    };
+};
+exports.startVaultPnlTracker = startVaultPnlTracker;

package/dist/vanity.d.ts

@@ -11,7 +11,7 @@ export declare const getBondingCurvePda: (mint: PublicKey) => [PublicKey, number
 export declare const getTokenTreasuryPda: (mint: PublicKey) => [PublicKey, number];
 export declare const getTreasuryLockPda: (mint: PublicKey) => [PublicKey, number];
 /** Grind for a keypair whose base58 address ends with "py" */
-export declare function grindPyreMint(maxAttempts?: number): Keypair;
+export declare const grindPyreMint: (maxAttempts?: number) => Keypair;
 /** Check if a mint address is a pyre faction (ends with "py") */
-export declare function isPyreMint(mint: string): boolean;
-export declare function buildCreateFactionTransaction(connection: Connection, params: CreateTokenParams): Promise<CreateTokenResult>;
+export declare const isPyreMint: (mint: string) => boolean;
+export declare const buildCreateFactionTransaction: (connection: Connection, params: CreateTokenParams) => Promise<CreateTokenResult>;

package/dist/vanity.js

@@ -10,10 +10,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTreasuryLockPda = exports.getTokenTreasuryPda = exports.getBondingCurvePda = void 0;
-exports.grindPyreMint = grindPyreMint;
-exports.isPyreMint = isPyreMint;
-exports.buildCreateFactionTransaction = buildCreateFactionTransaction;
+exports.buildCreateFactionTransaction = exports.isPyreMint = exports.grindPyreMint = exports.getTreasuryLockPda = exports.getTokenTreasuryPda = exports.getBondingCurvePda = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const anchor_1 = require("@coral-xyz/anchor");
@@ -53,7 +50,7 @@ const finalizeTransaction = async (connection, tx, feePayer) => {
 // ── Vanity grinder ──
 const PYRE_SUFFIX = 'py';
 /** Grind for a keypair whose base58 address ends with "py" */
-function grindPyreMint(maxAttempts = 500_000) {
+const grindPyreMint = (maxAttempts = 500_000) => {
     for (let i = 0; i < maxAttempts; i++) {
         const kp = web3_js_1.Keypair.generate();
         if (kp.publicKey.toBase58().endsWith(PYRE_SUFFIX)) {
@@ -62,21 +59,21 @@ function grindPyreMint(maxAttempts = 500_000) {
     }
     // Fallback — return last generated keypair (should be extremely rare)
     return web3_js_1.Keypair.generate();
-}
+};
+exports.grindPyreMint = grindPyreMint;
 /** Check if a mint address is a pyre faction (ends with "py") */
-function isPyreMint(mint) {
-    return mint.endsWith(PYRE_SUFFIX);
-}
+const isPyreMint = (mint) => mint.endsWith(PYRE_SUFFIX);
+exports.isPyreMint = isPyreMint;
 // ── Build create transaction with pyre vanity address ──
-async function buildCreateFactionTransaction(connection, params) {
-    const { creator: creatorStr, name, symbol, metadata_uri, sol_target = 0, community_token = true } = params;
+const buildCreateFactionTransaction = async (connection, params) => {
+    const { creator: creatorStr, name, symbol, metadata_uri, sol_target = 0, community_token = true, } = params;
     const creator = new web3_js_1.PublicKey(creatorStr);
     if (name.length > 32)
         throw new Error('Name must be 32 characters or less');
     if (symbol.length > 10)
         throw new Error('Symbol must be 10 characters or less');
     // Grind for "pyre" suffix instead of "tm"
-    const mint = grindPyreMint();
+    const mint = (0, exports.grindPyreMint)();
     // Derive PDAs
     const [globalConfig] = getGlobalConfigPda();
     const [bondingCurve] = (0, exports.getBondingCurvePda)(mint.publicKey);
@@ -88,8 +85,13 @@ async function buildCreateFactionTransaction(connection, params) {
     const tx = new web3_js_1.Transaction();
     const provider = makeDummyProvider(connection, creator);
     const program = new anchor_1.Program(torch_market_json_1.default, provider);
-    const createIx = await program.methods
-        .createToken({ name, symbol, uri: metadata_uri, solTarget: new anchor_1.BN(sol_target), communityToken: community_token })
+    const createIx = await program.methods.createToken({
+        name,
+        symbol,
+        uri: metadata_uri,
+        solTarget: new anchor_1.BN(sol_target),
+        communityToken: community_token,
+    })
         .accounts({
         creator,
         globalConfig,
@@ -116,4 +118,5 @@ async function buildCreateFactionTransaction(connection, params) {
         mintKeypair: mint,
         message: `Create faction "${name}" ($${symbol}) [pyre:${mint.publicKey.toBase58()}]`,
     };
-}
+};
+exports.buildCreateFactionTransaction = buildCreateFactionTransaction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyre-world-kit",
-  "version": "2.0.12",
+  "version": "3.0.1",
   "description": "Agent-first faction warfare kit — game-semantic wrapper over torchsdk",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,8 @@
     "build": "tsc",
     "test": "npx tsx tests/test_e2e.ts",
     "test:sim": "npx tsx tests/test_sim.ts",
-    "test:devnet": "npx tsx tests/test_devnet_e2e.ts"
+    "test:devnet": "npx tsx tests/test_devnet_e2e.ts",
+    "format": "prettier --write src/"
   },
   "dependencies": {
     "@coral-xyz/anchor": "^0.32.1",
@@ -19,6 +20,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
+    "prettier": "^3.5.3",
     "tsx": "^4.19.4",
     "typescript": "^5.9.3"
   },