pyre-world-kit 3.0.1 → 3.0.2

package/dist/index.d.ts

@@ -8,15 +8,15 @@
 import { Connection } from '@solana/web3.js';
 import { ActionProvider } from './providers/action.provider';
 import { IntelProvider } from './providers/intel.provider';
-import { RegistryProvider } from './providers/registry.provider';
 import { StateProvider } from './providers/state.provider';
 import type { Action } from './types/action.types';
 import type { Intel } from './types/intel.types';
 import type { CheckpointConfig } from './types/state.types';
+import { Registry } from './types/registry.types';
 export declare class PyreKit {
     readonly actions: ActionProvider;
     readonly intel: IntelProvider;
-    readonly registry: RegistryProvider;
+    readonly registry: Registry;
     readonly state: StateProvider;
     constructor(connection: Connection, publicKey: string);
     /** Callback fired when checkpoint interval is reached */

package/dist/index.js

@@ -20,8 +20,8 @@ class PyreKit {
     state;
     constructor(connection, publicKey) {
         this.registry = new registry_provider_1.RegistryProvider(connection);
-        this.state = new state_provider_1.StateProvider(connection, publicKey, this.registry);
-        this.actions = new action_provider_1.ActionProvider(connection);
+        this.state = new state_provider_1.StateProvider(connection, this.registry, publicKey);
+        this.actions = new action_provider_1.ActionProvider(connection, this.registry);
         this.intel = new intel_provider_1.IntelProvider(connection, this.actions);
         // Wire auto-checkpoint callback
         this.state.onCheckpointDue = () => this.onCheckpointDue?.();

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

@@ -2,10 +2,12 @@ import { Connection } from '@solana/web3.js';
 import { Action } from '../types/action.types';
 import { BuyQuoteResult, SellQuoteResult, TransactionResult } from 'torchsdk';
 import { AgentLink, AllWarLoansResult, AscendParams, ClaimSpoilsParams, CommsResult, CoupParams, CreateStrongholdParams, DefectParams, ExileAgentParams, FactionDetail, FactionListParams, FactionListResult, FactionStatus, FudFactionParams, FundStrongholdParams, JoinFactionParams, JoinFactionResult, LaunchFactionParams, LaunchFactionResult, MembersResult, MessageFactionParams, RallyParams, RazeParams, RecruitAgentParams, RepayWarLoanParams, RequestWarLoanParams, SiegeParams, Stronghold, TitheParams, WarChest, WarLoan, WarLoanQuote, WithdrawAssetsParams, WithdrawFromStrongholdParams } from '../types';
+import { Registry } from '../types/registry.types';
 export declare class ActionProvider implements Action {
     private connection;
+    private registryProvider;
     private mapper;
-    constructor(connection: Connection);
+    constructor(connection: Connection, registryProvider: Registry);
     createStronghold(params: CreateStrongholdParams): Promise<TransactionResult>;
     coup(params: CoupParams): Promise<TransactionResult>;
     exileAgent(params: ExileAgentParams): Promise<TransactionResult>;
@@ -41,6 +43,7 @@ export declare class ActionProvider implements Action {
     raze(params: RazeParams): Promise<TransactionResult>;
     repayWarLoan(params: RepayWarLoanParams): Promise<TransactionResult>;
     requestWarLoan(params: RequestWarLoanParams): Promise<TransactionResult>;
+    scout(targetAddress: string): Promise<string>;
     siege(params: SiegeParams): Promise<TransactionResult>;
     tithe(params: TitheParams): Promise<TransactionResult>;
 }

package/dist/providers/action.provider.js

@@ -8,9 +8,11 @@ const vanity_1 = require("../vanity");
 const util_1 = require("../util");
 class ActionProvider {
     connection;
+    registryProvider;
     mapper = new mapper_provider_1.MapperProvider();
-    constructor(connection) {
+    constructor(connection, registryProvider) {
         this.connection = connection;
+        this.registryProvider = registryProvider;
     }
     async createStronghold(params) {
         return (0, torchsdk_1.buildCreateVaultTransaction)(this.connection, { creator: params.creator });
@@ -310,6 +312,55 @@ class ActionProvider {
             vault: params.stronghold,
         });
     }
+    async scout(targetAddress) {
+        try {
+            const p = await this.registryProvider.getProfile(targetAddress);
+            if (!p)
+                return `  @${targetAddress.slice(0, 8)}: no pyre identity found`;
+            const total = p.joins +
+                p.defects +
+                p.rallies +
+                p.launches +
+                p.messages +
+                p.fuds +
+                p.infiltrates +
+                p.reinforces +
+                p.war_loans +
+                p.repay_loans +
+                p.sieges +
+                p.ascends +
+                p.razes +
+                p.tithes;
+            const topActions = [
+                { n: 'joins', v: p.joins },
+                { n: 'defects', v: p.defects },
+                { n: 'rallies', v: p.rallies },
+                { n: 'messages', v: p.messages },
+                { n: 'fuds', v: p.fuds },
+                { n: 'infiltrates', v: p.infiltrates },
+                { n: 'reinforces', v: p.reinforces },
+                { n: 'war_loans', v: p.war_loans },
+                { n: 'sieges', v: p.sieges },
+            ]
+                .sort((a, b) => b.v - a.v)
+                .filter((a) => a.v > 0)
+                .slice(0, 4)
+                .map((a) => `${a.n}:${a.v}`)
+                .join(', ');
+            const personality = p.personality_summary || 'unknown';
+            const checkpoint = p.last_checkpoint > 0
+                ? new Date(p.last_checkpoint * 1000).toISOString().slice(0, 10)
+                : 'never';
+            const spent = (p.total_sol_spent ?? 0) / 1e9;
+            const received = (p.total_sol_received ?? 0) / 1e9;
+            const pnl = received - spent;
+            const pnlStr = pnl >= 0 ? `+${pnl.toFixed(3)}` : pnl.toFixed(3);
+            return `  @${targetAddress.slice(0, 8)}: "${personality}" | ${total} actions (${topActions}) | P&L: ${pnlStr} SOL | last seen: ${checkpoint}`;
+        }
+        catch {
+            return `  @${targetAddress.slice(0, 8)}: lookup failed`;
+        }
+    }
     async siege(params) {
         return (0, torchsdk_1.buildLiquidateTransaction)(this.connection, {
             mint: params.mint,

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

@@ -8,15 +8,16 @@
 import { Connection, PublicKey } from '@solana/web3.js';
 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 class RegistryProvider {
+export declare class RegistryProvider implements Registry {
     private connection;
     constructor(connection: Connection);
     private getProgram;
-    getProfile(creator: string): Promise<RegistryProfile | null>;
-    getWalletLink(wallet: string): Promise<RegistryWalletLink | null>;
+    getProfile(creator: string): Promise<RegistryProfile | undefined>;
+    getWalletLink(wallet: string): Promise<RegistryWalletLink | undefined>;
     register(params: RegisterAgentParams): Promise<TransactionResult>;
     checkpoint(params: CheckpointParams): Promise<TransactionResult>;
     linkWallet(params: LinkAgentWalletParams): Promise<TransactionResult>;

package/dist/providers/registry.provider.js

@@ -87,7 +87,7 @@ class RegistryProvider {
             };
         }
         catch {
-            return null;
+            return undefined;
         }
     }
     async getWalletLink(wallet) {
@@ -105,7 +105,7 @@ class RegistryProvider {
             };
         }
         catch {
-            return null;
+            return undefined;
         }
     }
     // ─── Transaction Builders ─────────────────────────────────────────

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

@@ -7,15 +7,15 @@
  */
 import { Connection } from '@solana/web3.js';
 import type { State, AgentGameState, SerializedGameState, TrackedAction, CheckpointConfig } from '../types/state.types';
-import { RegistryProvider } from './registry.provider';
+import { Registry } from '../types/registry.types';
 export declare class StateProvider implements State {
     private connection;
-    private publicKey;
     private registry;
+    private publicKey;
     private _state;
     private checkpointConfig;
     private ticksSinceCheckpoint;
-    constructor(connection: Connection, publicKey: string, registry: RegistryProvider);
+    constructor(connection: Connection, registry: Registry, publicKey: string);
     get state(): AgentGameState | null;
     get vaultCreator(): string | null;
     get initialized(): boolean;

package/dist/providers/state.provider.js

@@ -62,15 +62,15 @@ const EMPTY_COUNTS = {
 };
 class StateProvider {
     connection;
-    publicKey;
     registry;
+    publicKey;
     _state = null;
     checkpointConfig = null;
     ticksSinceCheckpoint = 0;
-    constructor(connection, publicKey, registry) {
+    constructor(connection, registry, publicKey) {
         this.connection = connection;
-        this.publicKey = publicKey;
         this.registry = registry;
+        this.publicKey = publicKey;
     }
     // ─── Readonly accessors ─────────────────────────────────────────
     get state() {

package/dist/types/action.types.d.ts

@@ -36,6 +36,7 @@ export interface Action {
     raze(params: RazeParams): Promise<TransactionResult>;
     repayWarLoan(params: RepayWarLoanParams): Promise<TransactionResult>;
     requestWarLoan(params: RequestWarLoanParams): Promise<TransactionResult>;
+    scout(targetAddress: string): Promise<string>;
     siege(params: SiegeParams): Promise<TransactionResult>;
     tithe(params: TitheParams): Promise<TransactionResult>;
 }

package/dist/types/registry.types.d.ts

@@ -0,0 +1,10 @@
+import { CheckpointParams, LinkAgentWalletParams, RegisterAgentParams, RegistryProfile, RegistryWalletLink, TransactionResult, TransferAgentAuthorityParams, UnlinkAgentWalletParams } from '../types';
+export interface Registry {
+    getProfile(creator: string): Promise<RegistryProfile | undefined>;
+    getWalletLink(wallet: string): Promise<RegistryWalletLink | undefined>;
+    register(params: RegisterAgentParams): Promise<TransactionResult>;
+    checkpoint(params: CheckpointParams): Promise<TransactionResult>;
+    linkWallet(params: LinkAgentWalletParams): Promise<TransactionResult>;
+    unlinkWallet(params: UnlinkAgentWalletParams): Promise<TransactionResult>;
+    transferAuthority(params: TransferAgentAuthorityParams): Promise<TransactionResult>;
+}

package/dist/types/registry.types.js

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

package/package.json

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

package/src/index.ts

@@ -14,19 +14,20 @@ import { StateProvider } from './providers/state.provider'
 import type { Action } from './types/action.types'
 import type { Intel } from './types/intel.types'
 import type { State, CheckpointConfig, TrackedAction } from './types/state.types'
+import { Registry } from './types/registry.types'
 
 // ─── Top-level Kit ────────────────────────────────────────────────
 
 export class PyreKit {
   readonly actions: ActionProvider
   readonly intel: IntelProvider
-  readonly registry: RegistryProvider
+  readonly registry: Registry
   readonly state: StateProvider
 
   constructor(connection: Connection, publicKey: string) {
     this.registry = new RegistryProvider(connection)
-    this.state = new StateProvider(connection, publicKey, this.registry)
-    this.actions = new ActionProvider(connection)
+    this.state = new StateProvider(connection, this.registry, publicKey)
+    this.actions = new ActionProvider(connection, this.registry)
     this.intel = new IntelProvider(connection, this.actions)
 
     // Wire auto-checkpoint callback

package/src/providers/action.provider.ts

@@ -83,10 +83,14 @@ import {
   isPyreMint,
 } from '../vanity'
 import { isBlacklistedMint } from '../util'
+import { Registry } from '../types/registry.types'
 
 export class ActionProvider implements Action {
   private mapper = new MapperProvider()
-  constructor(private connection: Connection) {}
+  constructor(
+    private connection: Connection,
+    private registryProvider: Registry,
+  ) {}
 
   async createStronghold(params: CreateStrongholdParams): Promise<TransactionResult> {
     return buildCreateVaultTransaction(this.connection, { creator: params.creator })
@@ -422,6 +426,61 @@ export class ActionProvider implements Action {
     })
   }
 
+  async scout(targetAddress: string): Promise<string> {
+    try {
+      const p = await this.registryProvider.getProfile(targetAddress)
+      if (!p) return `  @${targetAddress.slice(0, 8)}: no pyre identity found`
+
+      const total =
+        p.joins +
+        p.defects +
+        p.rallies +
+        p.launches +
+        p.messages +
+        p.fuds +
+        p.infiltrates +
+        p.reinforces +
+        p.war_loans +
+        p.repay_loans +
+        p.sieges +
+        p.ascends +
+        p.razes +
+        p.tithes
+
+      const topActions = [
+        { n: 'joins', v: p.joins },
+        { n: 'defects', v: p.defects },
+        { n: 'rallies', v: p.rallies },
+        { n: 'messages', v: p.messages },
+        { n: 'fuds', v: p.fuds },
+        { n: 'infiltrates', v: p.infiltrates },
+        { n: 'reinforces', v: p.reinforces },
+        { n: 'war_loans', v: p.war_loans },
+        { n: 'sieges', v: p.sieges },
+      ]
+        .sort((a, b) => b.v - a.v)
+        .filter((a) => a.v > 0)
+        .slice(0, 4)
+        .map((a) => `${a.n}:${a.v}`)
+        .join(', ')
+
+      const personality = p.personality_summary || 'unknown'
+      const checkpoint =
+        p.last_checkpoint > 0
+          ? new Date(p.last_checkpoint * 1000).toISOString().slice(0, 10)
+          : 'never'
+
+      const spent = (p.total_sol_spent ?? 0) / 1e9
+      const received = (p.total_sol_received ?? 0) / 1e9
+      const pnl = received - spent
+      const pnlStr = pnl >= 0 ? `+${pnl.toFixed(3)}` : pnl.toFixed(3)
+
+      return `  @${targetAddress.slice(0, 8)}: "${personality}" | ${total} actions (${topActions}) | P&L: ${pnlStr} SOL | last seen: ${checkpoint}`
+    } catch {
+      return `  @${targetAddress.slice(0, 8)}: lookup failed`
+    }
+  }
+
   async siege(params: SiegeParams): Promise<TransactionResult> {
     return buildLiquidateTransaction(this.connection, {
       mint: params.mint,

package/src/providers/registry.provider.ts

@@ -20,6 +20,7 @@ import type {
 } from '../types'
 
 import idl from '../pyre_world.json'
+import { Registry } from '../types/registry.types'
 
 // ─── Program ID ─────────────────────────────────────────────────────
 
@@ -69,7 +70,7 @@ async function finalizeTransaction(
 
 // ─── Provider ───────────────────────────────────────────────────────
 
-export class RegistryProvider {
+export class RegistryProvider implements Registry {
   constructor(private connection: Connection) {}
 
   private getProgram(payer: PublicKey): Program {
@@ -79,7 +80,7 @@ export class RegistryProvider {
 
   // ─── Read Operations ──────────────────────────────────────────────
 
-  async getProfile(creator: string): Promise<RegistryProfile | null> {
+  async getProfile(creator: string): Promise<RegistryProfile | undefined> {
     const creatorPk = new PublicKey(creator)
     const [profilePda] = getAgentProfilePda(creatorPk)
     const program = this.getProgram(creatorPk)
@@ -113,11 +114,11 @@ export class RegistryProvider {
         total_sol_received: account.totalSolReceived?.toNumber() ?? 0,
       }
     } catch {
-      return null
+      return undefined
     }
   }
 
-  async getWalletLink(wallet: string): Promise<RegistryWalletLink | null> {
+  async getWalletLink(wallet: string): Promise<RegistryWalletLink | undefined> {
     const walletPk = new PublicKey(wallet)
     const [linkPda] = getAgentWalletLinkPda(walletPk)
     const program = this.getProgram(walletPk)
@@ -132,7 +133,7 @@ export class RegistryProvider {
         bump: account.bump,
       }
     } catch {
-      return null
+      return undefined
     }
   }
 

package/src/providers/state.provider.ts

@@ -17,6 +17,7 @@ import type {
 import { RegistryProvider } from './registry.provider'
 import { isPyreMint } from '../vanity'
 import { isBlacklistedMint } from '../util'
+import { Registry } from '../types/registry.types'
 
 const EMPTY_COUNTS: Record<TrackedAction, number> = {
   join: 0,
@@ -40,11 +41,7 @@ export class StateProvider implements State {
   private checkpointConfig: CheckpointConfig | null = null
   private ticksSinceCheckpoint = 0
 
-  constructor(
-    private connection: Connection,
-    private publicKey: string,
-    private registry: RegistryProvider,
-  ) {}
+  constructor(private connection: Connection, private registry: Registry, private publicKey: string) {}
 
   // ─── Readonly accessors ─────────────────────────────────────────
 

package/src/types/action.types.ts

@@ -71,6 +71,7 @@ export interface Action {
   raze(params: RazeParams): Promise<TransactionResult>
   repayWarLoan(params: RepayWarLoanParams): Promise<TransactionResult>
   requestWarLoan(params: RequestWarLoanParams): Promise<TransactionResult>
+  scout(targetAddress: string): Promise<string>
   siege(params: SiegeParams): Promise<TransactionResult>
   tithe(params: TitheParams): Promise<TransactionResult>
 }

package/src/types/registry.types.ts

@@ -0,0 +1,21 @@
+import {
+  CheckpointParams,
+  LinkAgentWalletParams,
+  RegisterAgentParams,
+  RegistryProfile,
+  RegistryWalletLink,
+  TransactionResult,
+  TransferAgentAuthorityParams,
+  UnlinkAgentWalletParams,
+} from '../types'
+
+export interface Registry {
+  getProfile(creator: string): Promise<RegistryProfile | undefined>
+  getWalletLink(wallet: string): Promise<RegistryWalletLink | undefined>
+
+  register(params: RegisterAgentParams): Promise<TransactionResult>
+  checkpoint(params: CheckpointParams): Promise<TransactionResult>
+  linkWallet(params: LinkAgentWalletParams): Promise<TransactionResult>
+  unlinkWallet(params: UnlinkAgentWalletParams): Promise<TransactionResult>
+  transferAuthority(params: TransferAgentAuthorityParams): Promise<TransactionResult>
+}