pyre-world-kit 2.0.11 → 3.0.0

package/dist/pyre_world.json

@@ -13,16 +13,7 @@
                 "Update action counters and personality summary.",
                 "Only the linked wallet can call this."
             ],
-            "discriminator": [
-                213,
-                200,
-                19,
-                204,
-                240,
-                143,
-                184,
-                252
-            ],
+            "discriminator": [213, 200, 19, 204, 240, 143, 184, 252],
             "accounts": [
                 {
                     "name": "signer",
@@ -59,24 +50,13 @@
                 "Link a new wallet to the profile. Authority only.",
                 "Must unlink existing wallet first."
             ],
-            "discriminator": [
-                86,
-                92,
-                31,
-                146,
-                228,
-                51,
-                209,
-                230
-            ],
+            "discriminator": [86, 92, 31, 146, 228, 51, 209, 230],
             "accounts": [
                 {
                     "name": "authority",
                     "writable": true,
                     "signer": true,
-                    "relations": [
-                        "profile"
-                    ]
+                    "relations": ["profile"]
                 },
                 {
                     "name": "profile",
@@ -85,18 +65,7 @@
                         "seeds": [
                             {
                                 "kind": "const",
-                                "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116
-                                ]
+                                "value": [112, 121, 114, 101, 95, 97, 103, 101, 110, 116]
                             },
                             {
                                 "kind": "account",
@@ -117,23 +86,7 @@
                             {
                                 "kind": "const",
                                 "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116,
-                                    95,
-                                    119,
-                                    97,
-                                    108,
-                                    108,
-                                    101,
-                                    116
+                                    112, 121, 114, 101, 95, 97, 103, 101, 110, 116, 95, 119, 97, 108, 108, 101, 116
                                 ]
                             },
                             {
@@ -152,19 +105,8 @@
         },
         {
             "name": "register",
-            "docs": [
-                "Register a new agent profile and auto-link the creator's wallet."
-            ],
-            "discriminator": [
-                211,
-                124,
-                67,
-                15,
-                211,
-                194,
-                178,
-                240
-            ],
+            "docs": ["Register a new agent profile and auto-link the creator's wallet."],
+            "discriminator": [211, 124, 67, 15, 211, 194, 178, 240],
             "accounts": [
                 {
                     "name": "creator",
@@ -178,18 +120,7 @@
                         "seeds": [
                             {
                                 "kind": "const",
-                                "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116
-                                ]
+                                "value": [112, 121, 114, 101, 95, 97, 103, 101, 110, 116]
                             },
                             {
                                 "kind": "account",
@@ -200,32 +131,14 @@
                 },
                 {
                     "name": "wallet_link",
-                    "docs": [
-                        "Auto-created wallet link for the creator"
-                    ],
+                    "docs": ["Auto-created wallet link for the creator"],
                     "writable": true,
                     "pda": {
                         "seeds": [
                             {
                                 "kind": "const",
                                 "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116,
-                                    95,
-                                    119,
-                                    97,
-                                    108,
-                                    108,
-                                    101,
-                                    116
+                                    112, 121, 114, 101, 95, 97, 103, 101, 110, 116, 95, 119, 97, 108, 108, 101, 116
                                 ]
                             },
                             {
@@ -244,26 +157,13 @@
         },
         {
             "name": "transfer_authority",
-            "docs": [
-                "Transfer profile authority to a new wallet."
-            ],
-            "discriminator": [
-                48,
-                169,
-                76,
-                72,
-                229,
-                180,
-                55,
-                161
-            ],
+            "docs": ["Transfer profile authority to a new wallet."],
+            "discriminator": [48, 169, 76, 72, 229, 180, 55, 161],
             "accounts": [
                 {
                     "name": "authority",
                     "signer": true,
-                    "relations": [
-                        "profile"
-                    ]
+                    "relations": ["profile"]
                 },
                 {
                     "name": "profile",
@@ -272,18 +172,7 @@
                         "seeds": [
                             {
                                 "kind": "const",
-                                "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116
-                                ]
+                                "value": [112, 121, 114, 101, 95, 97, 103, 101, 110, 116]
                             },
                             {
                                 "kind": "account",
@@ -301,27 +190,14 @@
         },
         {
             "name": "unlink_wallet",
-            "docs": [
-                "Unlink the current wallet. Authority only."
-            ],
-            "discriminator": [
-                220,
-                121,
-                97,
-                13,
-                193,
-                137,
-                209,
-                159
-            ],
+            "docs": ["Unlink the current wallet. Authority only."],
+            "discriminator": [220, 121, 97, 13, 193, 137, 209, 159],
             "accounts": [
                 {
                     "name": "authority",
                     "writable": true,
                     "signer": true,
-                    "relations": [
-                        "profile"
-                    ]
+                    "relations": ["profile"]
                 },
                 {
                     "name": "profile",
@@ -330,18 +206,7 @@
                         "seeds": [
                             {
                                 "kind": "const",
-                                "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116
-                                ]
+                                "value": [112, 121, 114, 101, 95, 97, 103, 101, 110, 116]
                             },
                             {
                                 "kind": "account",
@@ -362,23 +227,7 @@
                             {
                                 "kind": "const",
                                 "value": [
-                                    112,
-                                    121,
-                                    114,
-                                    101,
-                                    95,
-                                    97,
-                                    103,
-                                    101,
-                                    110,
-                                    116,
-                                    95,
-                                    119,
-                                    97,
-                                    108,
-                                    108,
-                                    101,
-                                    116
+                                    112, 121, 114, 101, 95, 97, 103, 101, 110, 116, 95, 119, 97, 108, 108, 101, 116
                                 ]
                             },
                             {
@@ -399,29 +248,11 @@
     "accounts": [
         {
             "name": "AgentProfile",
-            "discriminator": [
-                60,
-                227,
-                42,
-                24,
-                0,
-                87,
-                86,
-                205
-            ]
+            "discriminator": [60, 227, 42, 24, 0, 87, 86, 205]
         },
         {
             "name": "AgentWalletLink",
-            "discriminator": [
-                253,
-                251,
-                63,
-                168,
-                140,
-                233,
-                129,
-                156
-            ]
+            "discriminator": [253, 251, 63, 168, 140, 233, 129, 156]
         }
     ],
     "errors": [
@@ -467,37 +298,27 @@
                 "fields": [
                     {
                         "name": "creator",
-                        "docs": [
-                            "Immutable creator wallet — PDA seed (never changes)"
-                        ],
+                        "docs": ["Immutable creator wallet — PDA seed (never changes)"],
                         "type": "pubkey"
                     },
                     {
                         "name": "authority",
-                        "docs": [
-                            "Current authority — controls link/unlink/transfer (transferable)"
-                        ],
+                        "docs": ["Current authority — controls link/unlink/transfer (transferable)"],
                         "type": "pubkey"
                     },
                     {
                         "name": "linked_wallet",
-                        "docs": [
-                            "Current active wallet that can write checkpoints"
-                        ],
+                        "docs": ["Current active wallet that can write checkpoints"],
                         "type": "pubkey"
                     },
                     {
                         "name": "personality_summary",
-                        "docs": [
-                            "LLM-compressed personality paragraph (max 256 chars)"
-                        ],
+                        "docs": ["LLM-compressed personality paragraph (max 256 chars)"],
                         "type": "string"
                     },
                     {
                         "name": "last_checkpoint",
-                        "docs": [
-                            "Unix timestamp of last checkpoint"
-                        ],
+                        "docs": ["Unix timestamp of last checkpoint"],
                         "type": "i64"
                     },
                     {
@@ -558,30 +379,22 @@
                     },
                     {
                         "name": "created_at",
-                        "docs": [
-                            "Registration timestamp"
-                        ],
+                        "docs": ["Registration timestamp"],
                         "type": "i64"
                     },
                     {
                         "name": "bump",
-                        "docs": [
-                            "PDA bump"
-                        ],
+                        "docs": ["PDA bump"],
                         "type": "u8"
                     },
                     {
                         "name": "total_sol_spent",
-                        "docs": [
-                            "Cumulative SOL spent on joins/buys/infiltrates (lamports)"
-                        ],
+                        "docs": ["Cumulative SOL spent on joins/buys/infiltrates (lamports)"],
                         "type": "u64"
                     },
                     {
                         "name": "total_sol_received",
-                        "docs": [
-                            "Cumulative SOL received from defects/sells (lamports)"
-                        ],
+                        "docs": ["Cumulative SOL received from defects/sells (lamports)"],
                         "type": "u64"
                     }
                 ]
@@ -600,30 +413,22 @@
                 "fields": [
                     {
                         "name": "profile",
-                        "docs": [
-                            "The AgentProfile this wallet belongs to"
-                        ],
+                        "docs": ["The AgentProfile this wallet belongs to"],
                         "type": "pubkey"
                     },
                     {
                         "name": "wallet",
-                        "docs": [
-                            "The linked wallet"
-                        ],
+                        "docs": ["The linked wallet"],
                         "type": "pubkey"
                     },
                     {
                         "name": "linked_at",
-                        "docs": [
-                            "When this link was created"
-                        ],
+                        "docs": ["When this link was created"],
                         "type": "i64"
                     },
                     {
                         "name": "bump",
-                        "docs": [
-                            "PDA bump"
-                        ],
+                        "docs": ["PDA bump"],
                         "type": "u8"
                     }
                 ]

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

@@ -0,0 +1,41 @@
+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';
+export interface Action {
+    createStronghold(params: CreateStrongholdParams): Promise<TransactionResult>;
+    coup(params: CoupParams): Promise<TransactionResult>;
+    exileAgent(params: ExileAgentParams): Promise<TransactionResult>;
+    fundStronghold(params: FundStrongholdParams): Promise<TransactionResult>;
+    recruitAgent(params: RecruitAgentParams): Promise<TransactionResult>;
+    withdrawAssets(params: WithdrawAssetsParams): Promise<TransactionResult>;
+    withdrawFromStronghold(params: WithdrawFromStrongholdParams): Promise<TransactionResult>;
+    getAgentLink(wallet: string): Promise<AgentLink | undefined>;
+    getComms(mint: string, params: {
+        limit?: number;
+        status?: FactionStatus;
+    }): Promise<CommsResult>;
+    getDefectQuote(mint: string, amountTokens: number): Promise<SellQuoteResult>;
+    getJoinQuote(mint: string, amountSolLamports: number): Promise<BuyQuoteResult>;
+    getFaction(mint: string): Promise<FactionDetail>;
+    getFactions(params?: FactionListParams): Promise<FactionListResult>;
+    getLinkedAgents(vaultAddress: string): Promise<AgentLink[]>;
+    getMembers(mint: string, limit?: number): Promise<MembersResult>;
+    getStronghold(creator: string): Promise<Stronghold | undefined>;
+    getStrongholdForAgent(wallet: string): Promise<Stronghold | undefined>;
+    getWarChest(mint: string): Promise<WarChest>;
+    getWarLoan(mint: string, wallet: string): Promise<WarLoan>;
+    getWarLoanQuote(mint: string, collateralAmount: number): Promise<WarLoanQuote>;
+    getWarLoansForFaction(mint: string): Promise<AllWarLoansResult>;
+    ascend(params: AscendParams): Promise<TransactionResult>;
+    claimSpoils(params: ClaimSpoilsParams): Promise<TransactionResult>;
+    defect(params: DefectParams): Promise<TransactionResult>;
+    fud(params: FudFactionParams): Promise<TransactionResult>;
+    join(params: JoinFactionParams): Promise<JoinFactionResult>;
+    launch(params: LaunchFactionParams): Promise<LaunchFactionResult>;
+    message(params: MessageFactionParams): Promise<TransactionResult>;
+    rally(params: RallyParams): Promise<TransactionResult>;
+    raze(params: RazeParams): Promise<TransactionResult>;
+    repayWarLoan(params: RepayWarLoanParams): Promise<TransactionResult>;
+    requestWarLoan(params: RequestWarLoanParams): Promise<TransactionResult>;
+    siege(params: SiegeParams): Promise<TransactionResult>;
+    tithe(params: TitheParams): Promise<TransactionResult>;
+}

package/dist/types/action.types.js

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

package/dist/types/intel.types.d.ts

@@ -0,0 +1,20 @@
+import { AgentFactionPosition, AgentProfile, AllianceCluster, FactionPower, FactionStatus, RivalFaction, WorldEvent, WorldStats } from '../types';
+export interface Intel {
+    getAgentFactions(wallet: string, factionLimit?: number): Promise<AgentFactionPosition[]>;
+    getAgentProfile(wallet: string): Promise<AgentProfile>;
+    getAgentSolLamports(wallet: string): Promise<number>;
+    getAllies(mints: string[], holderLimit?: number): Promise<AllianceCluster[]>;
+    getFactionPower(mint: string): Promise<FactionPower>;
+    getFactionLeaderboard(opts?: {
+        status?: FactionStatus;
+        limit?: number;
+    }): Promise<FactionPower[]>;
+    getFactionRivals(mint: string, opts?: {
+        limit?: number;
+    }): Promise<RivalFaction[]>;
+    getWorldFeed(opts?: {
+        limit?: number;
+        factionLimit?: number;
+    }): Promise<WorldEvent[]>;
+    getWorldStats(): Promise<WorldStats>;
+}

package/dist/types/intel.types.js

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

package/dist/types/mapper.types.d.ts

@@ -0,0 +1,27 @@
+import { AllLoanPositionsResult, BuyTransactionResult, CreateTokenResult, Holder, HoldersResult, LendingInfo, LoanPositionInfo, LoanPositionWithKey, MessagesResult, TokenDetail, TokenListResult, TokenMessage, TokenStatus, TokenStatusFilter, TokenSummary, VaultInfo, VaultWalletLinkInfo } from 'torchsdk';
+import { AgentLink, AllWarLoansResult, Comms, CommsResult, FactionDetail, FactionListResult, FactionStatus, FactionStatusFilter, FactionSummary, JoinFactionResult, LaunchFactionResult, Member, MembersResult, Strategy, Stronghold, WarChest, WarLoan, WarLoanWithAgent } from '../types';
+export interface Mapper {
+    allLoansResult(r: AllLoanPositionsResult): AllWarLoansResult;
+    buyResult(r: BuyTransactionResult): JoinFactionResult;
+    createResult(r: CreateTokenResult): LaunchFactionResult;
+    factionStatus(status: TokenStatus): FactionStatus;
+    holdersResult(r: HoldersResult): MembersResult;
+    holderToMember(h: Holder): Member;
+    lendingToWarChest(l: LendingInfo): WarChest;
+    loanToWarLoan(l: LoanPositionInfo): WarLoan;
+    loanWithKeyToWarLoan(l: LoanPositionWithKey): WarLoanWithAgent;
+    messagesResult(r: MessagesResult): CommsResult;
+    strategy(vote: 'burn' | 'return'): Strategy;
+    tokenDetailToFaction(t: TokenDetail): FactionDetail;
+    tokenListResult(r: TokenListResult): FactionListResult;
+    tokenMessageToComms(m: TokenMessage): Comms;
+    tokenStatus(status: FactionStatus): TokenStatus;
+    tokenStatusFilter(status: FactionStatusFilter): TokenStatusFilter;
+    tokenSummaryToFaction(t: TokenSummary): FactionSummary;
+    vote(strategy: Strategy): 'burn' | 'return';
+    vaultToStronghold(v: VaultInfo): Stronghold;
+    walletLinkToAgentLink(l: VaultWalletLinkInfo): AgentLink;
+}
+export declare const STATUS_MAP: Record<TokenStatus, FactionStatus>;
+export declare const STATUS_REVERSE: Record<FactionStatus, TokenStatus>;
+export declare const STATUS_FILTER_REVERSE: Record<FactionStatusFilter, TokenStatusFilter>;

package/dist/types/mapper.types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATUS_FILTER_REVERSE = exports.STATUS_REVERSE = exports.STATUS_MAP = void 0;
+exports.STATUS_MAP = {
+    bonding: 'rising',
+    complete: 'ready',
+    migrated: 'ascended',
+    reclaimed: 'razed',
+};
+exports.STATUS_REVERSE = {
+    rising: 'bonding',
+    ready: 'complete',
+    ascended: 'migrated',
+    razed: 'reclaimed',
+};
+exports.STATUS_FILTER_REVERSE = {
+    rising: 'bonding',
+    ready: 'complete',
+    ascended: 'migrated',
+    razed: 'reclaimed',
+    all: 'all',
+};

package/dist/types/registry.types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/types/state.types.d.ts

@@ -0,0 +1,112 @@
+import type { Stronghold } from '../types';
+/** Action types tracked by the state provider */
+export type TrackedAction = 'join' | 'defect' | 'rally' | 'launch' | 'message' | 'reinforce' | 'war_loan' | 'repay_loan' | 'siege' | 'ascend' | 'raze' | 'tithe' | 'infiltrate' | 'fud';
+/** Snapshot of objective on-chain game state for an agent */
+export interface AgentGameState {
+    /** Agent wallet public key */
+    publicKey: string;
+    /** Vault creator key (resolved from on-chain vault link) */
+    vaultCreator: string | null;
+    /** Vault info (null if no vault found) */
+    stronghold: Stronghold | null;
+    /** Monotonic tick counter — increments on each successful action */
+    tick: number;
+    /** Cumulative action counts keyed by action type */
+    actionCounts: Record<TrackedAction, number>;
+    /** Token holdings: mint → balance (wallet + vault combined) */
+    holdings: Map<string, number>;
+    /** Mints with active war loans */
+    activeLoans: Set<string>;
+    /** Mints this agent founded */
+    founded: string[];
+    /** Mints already rallied (can only rally once) */
+    rallied: Set<string>;
+    /** Mints already voted on (first buy requires strategy vote) */
+    voted: Set<string>;
+    /** Sentiment per faction: mint → score (-10 to +10), derived from actions */
+    sentiment: Map<string, number>;
+    /** Recent action descriptions for LLM context / memory block */
+    recentHistory: string[];
+    /** Personality summary from on-chain registry checkpoint (null if no profile) */
+    personalitySummary: string | null;
+    /** Total SOL spent (from registry checkpoint, lamports) */
+    totalSolSpent: number;
+    /** Total SOL received (from registry checkpoint, lamports) */
+    totalSolReceived: number;
+    /** Whether state has been initialized from chain */
+    initialized: boolean;
+}
+/** Serializable form of AgentGameState for persistence */
+export interface SerializedGameState {
+    publicKey: string;
+    vaultCreator: string | null;
+    tick: number;
+    actionCounts: Record<TrackedAction, number>;
+    holdings: Record<string, number>;
+    activeLoans: string[];
+    founded: string[];
+    rallied: string[];
+    voted: string[];
+    sentiment: Record<string, number>;
+    recentHistory: string[];
+    personalitySummary: string | null;
+    totalSolSpent: number;
+    totalSolReceived: number;
+}
+/** Configuration for auto-checkpoint behavior */
+export interface CheckpointConfig {
+    /** Checkpoint every N ticks (default: 25) */
+    interval: number;
+    /** Personality summary string provider — called at checkpoint time */
+    getPersonalitySummary?: () => string;
+    /** SOL spent/received provider — called at checkpoint time */
+    getSolTotals?: () => {
+        spent: number;
+        received: number;
+    };
+}
+/** State provider interface — objective game state tracking */
+export interface State {
+    /** Current game state (null before init) */
+    readonly state: AgentGameState | null;
+    /** Vault creator key (shorthand for state.vaultCreator) */
+    readonly vaultCreator: string | null;
+    /** Whether state has been initialized */
+    readonly initialized: boolean;
+    /** Current tick count */
+    readonly tick: number;
+    /**
+     * Initialize state from chain.
+     * Resolves vault link, loads holdings, loads action counts from registry checkpoint.
+     * Must be called before any action. Returns the resolved state.
+     */
+    init(): Promise<AgentGameState>;
+    /**
+     * Record a successful action — increments tick, updates action counts,
+     * updates sentiment, appends to history, refreshes holdings.
+     * Called by ActionProvider after tx confirmation.
+     */
+    record(action: TrackedAction, mint?: string, description?: string): Promise<void>;
+    /** Refresh holdings from on-chain (wallet + vault token accounts) */
+    refreshHoldings(): Promise<void>;
+    /** Get sentiment score for a faction (-10 to +10) */
+    getSentiment(mint: string): number;
+    /** Get all sentiment entries */
+    readonly sentimentMap: ReadonlyMap<string, number>;
+    /** Get recent action history (for LLM memory block) */
+    readonly history: readonly string[];
+    /** Get token balance for a specific mint */
+    getBalance(mint: string): number;
+    /** Check if agent has voted on a faction */
+    hasVoted(mint: string): boolean;
+    /** Check if agent has rallied a faction */
+    hasRallied(mint: string): boolean;
+    /** Mark a faction as voted */
+    markVoted(mint: string): void;
+    /** Mark a faction as rallied */
+    markRallied(mint: string): void;
+    /** Serialize state for persistence */
+    serialize(): SerializedGameState;
+    /** Hydrate from a previously serialized state (skips chain reconstruction) */
+    hydrate(saved: SerializedGameState): void;
+}