pyre-world-kit 3.1.1 → 3.2.0

package/dist/index.d.ts

@@ -39,7 +39,7 @@ export declare class PyreKit {
     /** Map action method names to tracked action types */
     private methodToAction;
 }
-export type { FactionStatus, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, WarLoanQuote, LaunchFactionParams, JoinFactionParams, DefectParams, MessageFactionParams, FudFactionParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, JoinFactionResult, LaunchFactionResult, TransactionResult, EphemeralAgent, FactionSortOption, FactionStatusFilter, FactionListParams, FactionPower, AllianceCluster, RivalFaction, AgentProfile, AgentFactionPosition, WorldEventType, WorldEvent, WorldStats, RegistryProfile, RegistryWalletLink, CheckpointParams, RegisterAgentParams, LinkAgentWalletParams, UnlinkAgentWalletParams, TransferAgentAuthorityParams, } from './types';
+export type { FactionStatus, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, NearbyResult, MembersResult, CommsResult, AllWarLoansResult, WarLoanQuote, LaunchFactionParams, JoinFactionParams, DefectParams, MessageFactionParams, FudFactionParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, JoinFactionResult, LaunchFactionResult, TransactionResult, EphemeralAgent, FactionSortOption, FactionStatusFilter, FactionListParams, FactionPower, AllianceCluster, RivalFaction, AgentProfile, AgentFactionPosition, WorldEventType, WorldEvent, WorldStats, RegistryProfile, RegistryWalletLink, CheckpointParams, RegisterAgentParams, LinkAgentWalletParams, UnlinkAgentWalletParams, TransferAgentAuthorityParams, } from './types';
 export type { Action } from './types/action.types';
 export type { Intel } from './types/intel.types';
 export type { Mapper } from './types/mapper.types';

package/dist/providers/action.provider.js

@@ -194,7 +194,7 @@ class ActionProvider {
         });
     }
     async fud(params) {
-        const MICRO_SELL_TOKENS = 100;
+        const MICRO_SELL_TOKENS = 10 * 1_000_000; // 10 tokens in raw units (6 decimals)
         if (params.ascended) {
             const quote = await (0, torchsdk_1.getSellQuote)(this.connection, params.mint, MICRO_SELL_TOKENS);
             const minOut = Math.max(1, Math.floor(quote.output_sol * (1 - 500 / 10_000)));

package/dist/providers/intel.provider.d.ts

@@ -1,12 +1,18 @@
 import { Connection } from '@solana/web3.js';
-import { AgentFactionPosition, AgentProfile, AllianceCluster, FactionPower, FactionStatus, WorldEvent, WorldStats, RivalFaction } from '../types';
+import { AgentFactionPosition, AgentProfile, AllianceCluster, FactionListResult, FactionPower, FactionStatus, NearbyResult, WorldEvent, WorldStats, RivalFaction } from '../types';
 import { Intel } from '../types/intel.types';
 import { Action } from '../types/action.types';
 export declare class IntelProvider implements Intel {
     private connection;
     private actionProvider;
     constructor(connection: Connection, actionProvider: Action);
-    getAgentFactions(wallet: string, factionLimit?: number): Promise<AgentFactionPosition[]>;
+    getAgentFactions(wallet: string): Promise<AgentFactionPosition[]>;
+    getRisingFactions(limit?: number): Promise<FactionListResult>;
+    getAscendedFactions(limit?: number): Promise<FactionListResult>;
+    getNearbyFactions(wallet: string, { depth, limit }?: {
+        depth?: number;
+        limit?: number;
+    }): Promise<NearbyResult>;
     getAgentProfile(wallet: string): Promise<AgentProfile>;
     getAgentSolLamports(wallet: string): Promise<number>;
     getAllies(mints: string[], holderLimit?: number): Promise<AllianceCluster[]>;

package/dist/providers/intel.provider.js

@@ -44,28 +44,28 @@ class IntelProvider {
         this.connection = connection;
         this.actionProvider = actionProvider;
     }
-    async getAgentFactions(wallet, factionLimit = 50) {
+    async getAgentFactions(wallet) {
         const { TOKEN_2022_PROGRAM_ID } = await Promise.resolve().then(() => __importStar(require('@solana/spl-token')));
         const walletPk = new web3_js_1.PublicKey(wallet);
-        // Scan wallet token accounts
-        const walletAccounts = await this.connection.getParsedTokenAccountsByOwner(walletPk, {
-            programId: TOKEN_2022_PROGRAM_ID,
-        });
-        // Scan vault token accounts if a vault exists
-        let vaultAccounts = { context: walletAccounts.context, value: [] };
-        try {
-            const vault = await this.actionProvider.getStrongholdForAgent(wallet);
-            if (!vault)
-                throw new Error('no vault');
-            const vaultPk = new web3_js_1.PublicKey(vault.address);
-            vaultAccounts = await this.connection.getParsedTokenAccountsByOwner(vaultPk, {
+        // Parallel scan: wallet + vault
+        const vaultPromise = this.actionProvider.getStrongholdForAgent(wallet).catch(() => undefined);
+        const scanWallet = this.connection
+            .getParsedTokenAccountsByOwner(walletPk, { programId: TOKEN_2022_PROGRAM_ID })
+            .then((r) => r.value)
+            .catch(() => []);
+        const vault = await vaultPromise;
+        const scanVault = vault
+            ? this.connection
+                .getParsedTokenAccountsByOwner(new web3_js_1.PublicKey(vault.address), {
                 programId: TOKEN_2022_PROGRAM_ID,
-            });
-        }
-        catch { }
-        // Merge balances from both sources (wallet + vault)
+            })
+                .then((r) => r.value)
+                .catch(() => [])
+            : Promise.resolve([]);
+        const [walletValues, vaultValues] = await Promise.all([scanWallet, scanVault]);
+        // Merge balances from both sources
         const balanceMap = new Map();
-        for (const a of [...walletAccounts.value, ...vaultAccounts.value]) {
+        for (const a of [...walletValues, ...vaultValues]) {
             const mint = a.account.data.parsed.info.mint;
             const balance = Number(a.account.data.parsed.info.tokenAmount.uiAmount ?? 0);
             if (balance > 0 && (0, vanity_1.isPyreMint)(mint) && !(0, util_1.isBlacklistedMint)(mint)) {
@@ -74,28 +74,151 @@ class IntelProvider {
         }
         if (balanceMap.size === 0)
             return [];
-        // Fetch faction metadata for held mints
-        const allFactions = await this.actionProvider.getFactions({ limit: factionLimit });
-        const factionMap = new Map(allFactions.factions.map((t) => [t.mint, t]));
+        // Per-mint faction lookups (parallel)
         const positions = [];
-        for (const [mint, balance] of balanceMap) {
-            const faction = factionMap.get(mint);
-            if (!faction)
-                continue;
-            // balance / 1B total supply
-            const percentage = (balance / 1_000_000_000) * 100;
-            positions.push({
-                mint,
-                name: faction.name,
-                symbol: faction.symbol,
-                balance,
-                percentage,
-                value_sol: balance * faction.price_sol,
-            });
-        }
+        await Promise.all([...balanceMap.entries()].map(async ([mint, balance]) => {
+            try {
+                const faction = await this.actionProvider.getFaction(mint);
+                const percentage = (balance / 1_000_000_000) * 100;
+                positions.push({
+                    mint,
+                    name: faction.name,
+                    symbol: faction.symbol,
+                    balance,
+                    percentage,
+                    value_sol: balance * faction.price_sol,
+                });
+            }
+            catch { }
+        }));
         positions.sort((a, b) => b.value_sol - a.value_sol);
         return positions;
     }
+    async getRisingFactions(limit = 50) {
+        return this.actionProvider.getFactions({ limit, status: 'rising' });
+    }
+    async getAscendedFactions(limit = 50) {
+        return this.actionProvider.getFactions({ limit, status: 'ascended' });
+    }
+    async getNearbyFactions(wallet, { depth = 1, limit = 50 } = {}) {
+        const { TOKEN_2022_PROGRAM_ID } = await Promise.resolve().then(() => __importStar(require('@solana/spl-token')));
+        // Resolve wallet → vault (tokens live in vaults, not wallets)
+        let seedAddress = wallet;
+        try {
+            const vault = await this.actionProvider.getStrongholdForAgent(wallet);
+            if (vault)
+                seedAddress = vault.address;
+        }
+        catch { }
+        const discoveredMints = new Set();
+        const factionCache = new Map();
+        const visitedAddresses = new Set([wallet, seedAddress]);
+        /** Scan an address (wallet or vault) for Pyre token holdings */
+        const scanHoldings = async (address) => {
+            const mints = [];
+            try {
+                const accounts = await this.connection.getParsedTokenAccountsByOwner(new web3_js_1.PublicKey(address), { programId: TOKEN_2022_PROGRAM_ID });
+                for (const a of accounts.value) {
+                    const mint = a.account.data.parsed.info.mint;
+                    const balance = Number(a.account.data.parsed.info.tokenAmount.uiAmount ?? 0);
+                    if (balance > 0 && (0, vanity_1.isPyreMint)(mint) && !(0, util_1.isBlacklistedMint)(mint)) {
+                        mints.push(mint);
+                    }
+                }
+            }
+            catch { }
+            return mints;
+        };
+        /** Look up faction metadata, skip if already cached */
+        const resolveFaction = async (mint) => {
+            if (factionCache.has(mint))
+                return;
+            try {
+                const detail = await this.actionProvider.getFaction(mint);
+                factionCache.set(mint, {
+                    mint: detail.mint,
+                    name: detail.name,
+                    symbol: detail.symbol,
+                    status: detail.status,
+                    market_cap_sol: detail.market_cap_sol,
+                    price_sol: detail.price_sol,
+                    members: detail.members ?? 0,
+                    progress_percent: detail.progress_percent,
+                    created_at: detail.created_at,
+                    last_activity_at: detail.last_activity_at,
+                });
+            }
+            catch { }
+        };
+        // Seed: scan own vault for held factions
+        const seedMints = await scanHoldings(seedAddress);
+        for (const m of seedMints)
+            discoveredMints.add(m);
+        if (discoveredMints.size === 0) {
+            const fallback = await this.actionProvider.getFactions({ limit, sort: 'newest' });
+            return { ...fallback, allies: [] };
+        }
+        // BFS across the social graph via comms — senders are wallet addresses
+        const COMMS_PER_FACTION = 20;
+        const MAX_WALLETS_PER_HOP = 20;
+        const discoveredAllies = [];
+        let frontierMints = new Set(discoveredMints);
+        for (let d = 0; d < depth; d++) {
+            // 1. Get recent comms senders from frontier factions → next frontier wallets
+            const nextFrontier = new Set();
+            await Promise.all([...frontierMints].slice(0, 10).map(async (mint) => {
+                try {
+                    const { comms } = await this.actionProvider.getComms(mint, { limit: COMMS_PER_FACTION });
+                    for (const c of comms) {
+                        if (!visitedAddresses.has(c.sender)) {
+                            nextFrontier.add(c.sender);
+                            visitedAddresses.add(c.sender);
+                            discoveredAllies.push(c.sender);
+                        }
+                    }
+                }
+                catch { }
+            }));
+            if (nextFrontier.size === 0)
+                break;
+            // 2. Resolve wallets → vaults, scan for holdings → discover new mints
+            const newMints = new Set();
+            await Promise.all([...nextFrontier].slice(0, MAX_WALLETS_PER_HOP).map(async (walletAddr) => {
+                // Resolve to vault — tokens live there
+                let scanAddr = walletAddr;
+                try {
+                    const v = await this.actionProvider.getStrongholdForAgent(walletAddr);
+                    if (v)
+                        scanAddr = v.address;
+                }
+                catch { }
+                const mints = await scanHoldings(scanAddr);
+                for (const mint of mints) {
+                    if (!discoveredMints.has(mint)) {
+                        newMints.add(mint);
+                        discoveredMints.add(mint);
+                    }
+                }
+            }));
+            // New mints become the frontier for the next depth level
+            frontierMints = newMints;
+            if (frontierMints.size === 0)
+                break;
+        }
+        // Resolve faction metadata per mint (parallel, cached)
+        await Promise.all([...discoveredMints].map(resolveFaction));
+        const nearbyFactions = [...discoveredMints]
+            .map((mint) => factionCache.get(mint))
+            .filter((f) => f != null)
+            .slice(0, limit);
+        return {
+            factions: nearbyFactions,
+            allies: discoveredAllies,
+            total: nearbyFactions.length,
+            limit,
+            offset: 0,
+        };
+    }
     async getAgentProfile(wallet) {
         const vault = await this.actionProvider.getStrongholdForAgent(wallet);
         const factions = await this.getAgentFactions(wallet);

package/dist/providers/registry.provider.d.ts

@@ -3,10 +3,11 @@ import type { TransactionResult } from 'torchsdk';
 import type { RegistryProfile, RegistryWalletLink, RegisterAgentParams, CheckpointParams, LinkAgentWalletParams, UnlinkAgentWalletParams, TransferAgentAuthorityParams } from '../types';
 import { Registry } from '../types/registry.types';
 export declare const REGISTRY_PROGRAM_ID: PublicKey;
-export declare function getAgentProfilePda(creator: PublicKey): [PublicKey, number];
-export declare function getAgentWalletLinkPda(wallet: PublicKey): [PublicKey, number];
+export declare const getAgentProfilePda: (creator: PublicKey) => [PublicKey, number];
+export declare const getAgentWalletLinkPda: (wallet: PublicKey) => [PublicKey, number];
 export declare class RegistryProvider implements Registry {
     private connection;
+    private _programCache;
     constructor(connection: Connection);
     private getProgram;
     getProfile(creator: string): Promise<RegistryProfile | undefined>;

package/dist/providers/registry.provider.js

@@ -3,29 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegistryProvider = exports.REGISTRY_PROGRAM_ID = void 0;
-exports.getAgentProfilePda = getAgentProfilePda;
-exports.getAgentWalletLinkPda = getAgentWalletLinkPda;
+exports.RegistryProvider = exports.getAgentWalletLinkPda = exports.getAgentProfilePda = exports.REGISTRY_PROGRAM_ID = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const anchor_1 = require("@coral-xyz/anchor");
 const pyre_world_json_1 = __importDefault(require("../pyre_world.json"));
 exports.REGISTRY_PROGRAM_ID = new web3_js_1.PublicKey(pyre_world_json_1.default.address);
 const AGENT_SEED = 'pyre_agent';
 const AGENT_WALLET_SEED = 'pyre_agent_wallet';
-function getAgentProfilePda(creator) {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(AGENT_SEED), creator.toBuffer()], exports.REGISTRY_PROGRAM_ID);
-}
-function getAgentWalletLinkPda(wallet) {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(AGENT_WALLET_SEED), wallet.toBuffer()], exports.REGISTRY_PROGRAM_ID);
-}
-function makeDummyProvider(connection, payer) {
-    const dummyWallet = {
-        publicKey: payer,
-        signTransaction: async (t) => t,
-        signAllTransactions: async (t) => t,
-    };
-    return new anchor_1.AnchorProvider(connection, dummyWallet, {});
-}
+const getAgentProfilePda = (creator) => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(AGENT_SEED), creator.toBuffer()], exports.REGISTRY_PROGRAM_ID);
+exports.getAgentProfilePda = getAgentProfilePda;
+const getAgentWalletLinkPda = (wallet) => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(AGENT_WALLET_SEED), wallet.toBuffer()], exports.REGISTRY_PROGRAM_ID);
+exports.getAgentWalletLinkPda = getAgentWalletLinkPda;
+const makeDummyProvider = (connection, payer) => new anchor_1.AnchorProvider(connection, {
+    publicKey: payer,
+    signTransaction: async (t) => t,
+    signAllTransactions: async (t) => t,
+}, {});
 async function finalizeTransaction(connection, tx, feePayer) {
     const { blockhash } = await connection.getLatestBlockhash();
     tx.recentBlockhash = blockhash;
@@ -33,16 +26,23 @@ async function finalizeTransaction(connection, tx, feePayer) {
 }
 class RegistryProvider {
     connection;
+    _programCache = new Map();
     constructor(connection) {
         this.connection = connection;
     }
     getProgram(payer) {
-        const provider = makeDummyProvider(this.connection, payer);
-        return new anchor_1.Program(pyre_world_json_1.default, provider);
+        const key = payer.toBase58();
+        let program = this._programCache.get(key);
+        if (!program) {
+            const provider = makeDummyProvider(this.connection, payer);
+            program = new anchor_1.Program(pyre_world_json_1.default, provider);
+            this._programCache.set(key, program);
+        }
+        return program;
     }
     async getProfile(creator) {
         const creatorPk = new web3_js_1.PublicKey(creator);
-        const [profilePda] = getAgentProfilePda(creatorPk);
+        const [profilePda] = (0, exports.getAgentProfilePda)(creatorPk);
         const program = this.getProgram(creatorPk);
         try {
             const account = await program.account.agentProfile.fetch(profilePda);
@@ -79,7 +79,7 @@ class RegistryProvider {
     }
     async getWalletLink(wallet) {
         const walletPk = new web3_js_1.PublicKey(wallet);
-        const [linkPda] = getAgentWalletLinkPda(walletPk);
+        const [linkPda] = (0, exports.getAgentWalletLinkPda)(walletPk);
         const program = this.getProgram(walletPk);
         try {
             const account = await program.account.agentWalletLink.fetch(linkPda);
@@ -97,8 +97,8 @@ class RegistryProvider {
     }
     async register(params) {
         const creator = new web3_js_1.PublicKey(params.creator);
-        const [profile] = getAgentProfilePda(creator);
-        const [walletLink] = getAgentWalletLinkPda(creator);
+        const [profile] = (0, exports.getAgentProfilePda)(creator);
+        const [walletLink] = (0, exports.getAgentWalletLinkPda)(creator);
         const program = this.getProgram(creator);
         const tx = new web3_js_1.Transaction();
         const ix = await program.methods.register()
@@ -114,7 +114,7 @@ class RegistryProvider {
     async checkpoint(params) {
         const signer = new web3_js_1.PublicKey(params.signer);
         const creatorPk = new web3_js_1.PublicKey(params.creator);
-        const [profile] = getAgentProfilePda(creatorPk);
+        const [profile] = (0, exports.getAgentProfilePda)(creatorPk);
         const program = this.getProgram(signer);
         const args = {
             joins: new anchor_1.BN(params.joins),
@@ -150,8 +150,8 @@ class RegistryProvider {
         const authority = new web3_js_1.PublicKey(params.authority);
         const creatorPk = new web3_js_1.PublicKey(params.creator);
         const walletToLink = new web3_js_1.PublicKey(params.wallet_to_link);
-        const [profile] = getAgentProfilePda(creatorPk);
-        const [walletLink] = getAgentWalletLinkPda(walletToLink);
+        const [profile] = (0, exports.getAgentProfilePda)(creatorPk);
+        const [walletLink] = (0, exports.getAgentWalletLinkPda)(walletToLink);
         const program = this.getProgram(authority);
         const tx = new web3_js_1.Transaction();
         const ix = await program.methods.linkWallet()
@@ -174,8 +174,8 @@ class RegistryProvider {
         const authority = new web3_js_1.PublicKey(params.authority);
         const creatorPk = new web3_js_1.PublicKey(params.creator);
         const walletToUnlink = new web3_js_1.PublicKey(params.wallet_to_unlink);
-        const [profile] = getAgentProfilePda(creatorPk);
-        const [walletLink] = getAgentWalletLinkPda(walletToUnlink);
+        const [profile] = (0, exports.getAgentProfilePda)(creatorPk);
+        const [walletLink] = (0, exports.getAgentWalletLinkPda)(walletToUnlink);
         const program = this.getProgram(authority);
         const tx = new web3_js_1.Transaction();
         const ix = await program.methods.unlinkWallet()
@@ -198,7 +198,7 @@ class RegistryProvider {
         const authority = new web3_js_1.PublicKey(params.authority);
         const creatorPk = new web3_js_1.PublicKey(params.creator);
         const newAuthority = new web3_js_1.PublicKey(params.new_authority);
-        const [profile] = getAgentProfilePda(creatorPk);
+        const [profile] = (0, exports.getAgentProfilePda)(creatorPk);
         const program = this.getProgram(authority);
         const tx = new web3_js_1.Transaction();
         const ix = await program.methods.transferAuthority()

package/dist/providers/state.provider.d.ts

@@ -1,4 +1,5 @@
 import { Connection } from '@solana/web3.js';
+import type { Stronghold } from '../types';
 import type { State, AgentGameState, SerializedGameState, TrackedAction, CheckpointConfig } from '../types/state.types';
 import { Registry } from '../types/registry.types';
 export declare class StateProvider implements State {
@@ -8,22 +9,26 @@ export declare class StateProvider implements State {
     private _state;
     private checkpointConfig;
     private ticksSinceCheckpoint;
+    private _vaultCreator;
+    private _stronghold;
+    private _vaultPromise;
     constructor(connection: Connection, registry: Registry, publicKey: string);
     get state(): AgentGameState | null;
-    get vaultCreator(): string | null;
     get initialized(): boolean;
     get tick(): number;
-    /** Configure auto-checkpoint behavior */
     setCheckpointConfig(config: CheckpointConfig): void;
+    private resolveVault;
+    getVaultCreator(): Promise<string | null>;
+    getStronghold(): Promise<Stronghold | null>;
     init(): Promise<AgentGameState>;
     record(action: TrackedAction, mint?: string, description?: string): Promise<void>;
     private updateSentiment;
     onCheckpointDue: (() => void) | null;
-    refreshHoldings(): Promise<void>;
+    getHoldings(): Promise<Map<string, number>>;
+    getBalance(mint: string): Promise<number>;
     getSentiment(mint: string): number;
     get sentimentMap(): ReadonlyMap<string, number>;
     get history(): readonly string[];
-    getBalance(mint: string): number;
     hasVoted(mint: string): boolean;
     hasRallied(mint: string): boolean;
     markVoted(mint: string): void;