pyre-world-kit 2.0.11 → 3.0.0

package/dist/providers/mapper.provider.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Pyre Kit Mappers
+ *
+ * Internal mapping functions between Torch SDK types and Pyre game types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapperProvider = void 0;
+const mapper_types_1 = require("../types/mapper.types");
+class MapperProvider {
+    allLoansResult = (r) => ({
+        positions: r.positions.map(this.loanWithKeyToWarLoan),
+        pool_price_sol: r.pool_price_sol,
+    });
+    buyResult = (r) => ({
+        transaction: r.transaction,
+        additionalTransactions: r.additionalTransactions,
+        message: r.message,
+        migrationTransaction: r.migrationTransaction,
+    });
+    createResult = (r) => ({
+        transaction: r.transaction,
+        additionalTransactions: r.additionalTransactions,
+        message: r.message,
+        mint: r.mint,
+        mintKeypair: r.mintKeypair,
+    });
+    factionStatus = (status) => mapper_types_1.STATUS_MAP[status];
+    holdersResult = (r) => ({
+        members: r.holders.map(this.holderToMember),
+        total_members: r.total_holders,
+    });
+    holderToMember = (h) => ({
+        address: h.address,
+        balance: h.balance,
+        percentage: h.percentage,
+    });
+    lendingToWarChest = (l) => ({
+        interest_rate_bps: l.interest_rate_bps,
+        max_ltv_bps: l.max_ltv_bps,
+        liquidation_threshold_bps: l.liquidation_threshold_bps,
+        liquidation_bonus_bps: l.liquidation_bonus_bps,
+        utilization_cap_bps: l.utilization_cap_bps,
+        borrow_share_multiplier: l.borrow_share_multiplier,
+        total_sol_lent: l.total_sol_lent,
+        active_loans: l.active_loans,
+        war_chest_sol_available: l.treasury_sol_available,
+        warnings: l.warnings,
+    });
+    loanToWarLoan = (l) => ({
+        collateral_amount: l.collateral_amount,
+        borrowed_amount: l.borrowed_amount,
+        accrued_interest: l.accrued_interest,
+        total_owed: l.total_owed,
+        collateral_value_sol: l.collateral_value_sol,
+        current_ltv_bps: l.current_ltv_bps,
+        health: l.health,
+        warnings: l.warnings,
+    });
+    loanWithKeyToWarLoan = (l) => ({
+        ...this.loanToWarLoan(l),
+        borrower: l.borrower,
+    });
+    messagesResult = (r) => ({
+        comms: r.messages.map(this.tokenMessageToComms),
+        total: r.total,
+    });
+    strategy = (vote) => (vote === 'burn' ? 'smelt' : 'fortify');
+    tokenDetailToFaction = (t) => ({
+        mint: t.mint,
+        name: t.name,
+        symbol: t.symbol,
+        description: t.description,
+        image: t.image,
+        status: this.factionStatus(t.status),
+        price_sol: t.price_sol,
+        price_usd: t.price_usd,
+        market_cap_sol: t.market_cap_sol,
+        market_cap_usd: t.market_cap_usd,
+        progress_percent: t.progress_percent,
+        sol_raised: t.sol_raised,
+        sol_target: t.sol_target,
+        total_supply: t.total_supply,
+        circulating_supply: t.circulating_supply,
+        tokens_in_curve: t.tokens_in_curve,
+        tokens_in_vote_vault: t.tokens_in_vote_vault,
+        tokens_burned: t.tokens_burned,
+        war_chest_sol: t.treasury_sol_balance,
+        war_chest_tokens: t.treasury_token_balance,
+        total_bought_back: t.total_bought_back,
+        buyback_count: t.buyback_count,
+        votes_scorched_earth: t.votes_burn,
+        votes_fortify: t.votes_return,
+        founder: t.creator,
+        members: t.holders,
+        rallies: t.stars,
+        created_at: t.created_at,
+        last_activity_at: t.last_activity_at,
+        twitter: t.twitter,
+        telegram: t.telegram,
+        website: t.website,
+        founder_verified: t.creator_verified,
+        founder_trust_tier: t.creator_trust_tier,
+        founder_said_name: t.creator_said_name,
+        founder_badge_url: t.creator_badge_url,
+        warnings: t.warnings,
+    });
+    tokenListResult = (r) => ({
+        factions: r.tokens.map(this.tokenSummaryToFaction),
+        total: r.total,
+        limit: r.limit,
+        offset: r.offset,
+    });
+    tokenMessageToComms = (m) => ({
+        signature: m.signature,
+        memo: m.memo,
+        sender: m.sender,
+        timestamp: m.timestamp,
+        sender_verified: m.sender_verified,
+        sender_trust_tier: m.sender_trust_tier,
+        sender_said_name: m.sender_said_name,
+        sender_badge_url: m.sender_badge_url,
+    });
+    tokenStatus = (status) => mapper_types_1.STATUS_REVERSE[status];
+    tokenStatusFilter = (status) => mapper_types_1.STATUS_FILTER_REVERSE[status];
+    tokenSummaryToFaction = (t) => ({
+        mint: t.mint,
+        name: t.name,
+        symbol: t.symbol,
+        status: this.factionStatus(t.status),
+        price_sol: t.price_sol,
+        market_cap_sol: t.market_cap_sol,
+        progress_percent: t.progress_percent,
+        members: t.holders,
+        created_at: t.created_at,
+        last_activity_at: t.last_activity_at,
+    });
+    vote = (strategy) => (strategy === 'smelt' ? 'burn' : 'return');
+    vaultToStronghold = (v) => ({
+        address: v.address,
+        creator: v.creator,
+        authority: v.authority,
+        sol_balance: v.sol_balance,
+        total_deposited: v.total_deposited,
+        total_withdrawn: v.total_withdrawn,
+        total_spent: v.total_spent,
+        total_received: v.total_received,
+        linked_agents: v.linked_wallets,
+        created_at: v.created_at,
+    });
+    walletLinkToAgentLink = (l) => ({
+        address: l.address,
+        stronghold: l.vault,
+        wallet: l.wallet,
+        linked_at: l.linked_at,
+    });
+}
+exports.MapperProvider = MapperProvider;

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

@@ -0,0 +1,25 @@
+/**
+ * Pyre World Agent Registry Provider
+ *
+ * On-chain agent identity and state persistence.
+ * Agents checkpoint their action distributions and personality summaries
+ * so any machine with the wallet key can reconstruct the agent.
+ */
+import { Connection, PublicKey } from '@solana/web3.js';
+import type { TransactionResult } from 'torchsdk';
+import type { RegistryProfile, RegistryWalletLink, RegisterAgentParams, CheckpointParams, LinkAgentWalletParams, UnlinkAgentWalletParams, TransferAgentAuthorityParams } from '../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 {
+    private connection;
+    constructor(connection: Connection);
+    private getProgram;
+    getProfile(creator: string): Promise<RegistryProfile | null>;
+    getWalletLink(wallet: string): Promise<RegistryWalletLink | null>;
+    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/providers/registry.provider.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * Pyre World Agent Registry Provider
+ *
+ * On-chain agent identity and state persistence.
+ * Agents checkpoint their action distributions and personality summaries
+ * so any machine with the wallet key can reconstruct the agent.
+ */
+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;
+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"));
+// ─── Program ID ─────────────────────────────────────────────────────
+exports.REGISTRY_PROGRAM_ID = new web3_js_1.PublicKey(pyre_world_json_1.default.address);
+// ─── PDA Seeds ──────────────────────────────────────────────────────
+const AGENT_SEED = 'pyre_agent';
+const AGENT_WALLET_SEED = 'pyre_agent_wallet';
+// ─── PDA Helpers ────────────────────────────────────────────────────
+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);
+}
+// ─── Anchor Program Helper ──────────────────────────────────────────
+function makeDummyProvider(connection, payer) {
+    const dummyWallet = {
+        publicKey: payer,
+        signTransaction: async (t) => t,
+        signAllTransactions: async (t) => t,
+    };
+    return new anchor_1.AnchorProvider(connection, dummyWallet, {});
+}
+async function finalizeTransaction(connection, tx, feePayer) {
+    const { blockhash } = await connection.getLatestBlockhash();
+    tx.recentBlockhash = blockhash;
+    tx.feePayer = feePayer;
+}
+// ─── Provider ───────────────────────────────────────────────────────
+class RegistryProvider {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    getProgram(payer) {
+        const provider = makeDummyProvider(this.connection, payer);
+        return new anchor_1.Program(pyre_world_json_1.default, provider);
+    }
+    // ─── Read Operations ──────────────────────────────────────────────
+    async getProfile(creator) {
+        const creatorPk = new web3_js_1.PublicKey(creator);
+        const [profilePda] = getAgentProfilePda(creatorPk);
+        const program = this.getProgram(creatorPk);
+        try {
+            const account = await program.account.agentProfile.fetch(profilePda);
+            return {
+                address: profilePda.toBase58(),
+                creator: account.creator.toBase58(),
+                authority: account.authority.toBase58(),
+                linked_wallet: account.linkedWallet.toBase58(),
+                personality_summary: account.personalitySummary,
+                last_checkpoint: account.lastCheckpoint.toNumber(),
+                joins: account.joins.toNumber(),
+                defects: account.defects.toNumber(),
+                rallies: account.rallies.toNumber(),
+                launches: account.launches.toNumber(),
+                messages: account.messages.toNumber(),
+                fuds: account.fuds.toNumber(),
+                infiltrates: account.infiltrates.toNumber(),
+                reinforces: account.reinforces.toNumber(),
+                war_loans: account.warLoans.toNumber(),
+                repay_loans: account.repayLoans.toNumber(),
+                sieges: account.sieges.toNumber(),
+                ascends: account.ascends.toNumber(),
+                razes: account.razes.toNumber(),
+                tithes: account.tithes.toNumber(),
+                created_at: account.createdAt.toNumber(),
+                bump: account.bump,
+                total_sol_spent: account.totalSolSpent?.toNumber() ?? 0,
+                total_sol_received: account.totalSolReceived?.toNumber() ?? 0,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async getWalletLink(wallet) {
+        const walletPk = new web3_js_1.PublicKey(wallet);
+        const [linkPda] = getAgentWalletLinkPda(walletPk);
+        const program = this.getProgram(walletPk);
+        try {
+            const account = await program.account.agentWalletLink.fetch(linkPda);
+            return {
+                address: linkPda.toBase58(),
+                profile: account.profile.toBase58(),
+                wallet: account.wallet.toBase58(),
+                linked_at: account.linkedAt.toNumber(),
+                bump: account.bump,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Transaction Builders ─────────────────────────────────────────
+    async register(params) {
+        const creator = new web3_js_1.PublicKey(params.creator);
+        const [profile] = getAgentProfilePda(creator);
+        const [walletLink] = getAgentWalletLinkPda(creator);
+        const program = this.getProgram(creator);
+        const tx = new web3_js_1.Transaction();
+        const ix = await program.methods.register()
+            .accounts({ creator, profile, walletLink, systemProgram: web3_js_1.SystemProgram.programId })
+            .instruction();
+        tx.add(ix);
+        await finalizeTransaction(this.connection, tx, creator);
+        return {
+            transaction: tx,
+            message: `Register agent profile [${profile.toBase58()}]`,
+        };
+    }
+    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 program = this.getProgram(signer);
+        const args = {
+            joins: new anchor_1.BN(params.joins),
+            defects: new anchor_1.BN(params.defects),
+            rallies: new anchor_1.BN(params.rallies),
+            launches: new anchor_1.BN(params.launches),
+            messages: new anchor_1.BN(params.messages),
+            fuds: new anchor_1.BN(params.fuds),
+            infiltrates: new anchor_1.BN(params.infiltrates),
+            reinforces: new anchor_1.BN(params.reinforces),
+            warLoans: new anchor_1.BN(params.war_loans),
+            repayLoans: new anchor_1.BN(params.repay_loans),
+            sieges: new anchor_1.BN(params.sieges),
+            ascends: new anchor_1.BN(params.ascends),
+            razes: new anchor_1.BN(params.razes),
+            tithes: new anchor_1.BN(params.tithes),
+            personalitySummary: params.personality_summary,
+            totalSolSpent: new anchor_1.BN(params.total_sol_spent),
+            totalSolReceived: new anchor_1.BN(params.total_sol_received),
+        };
+        const tx = new web3_js_1.Transaction();
+        const ix = await program.methods.checkpoint(args)
+            .accounts({ signer, profile, systemProgram: web3_js_1.SystemProgram.programId })
+            .instruction();
+        tx.add(ix);
+        await finalizeTransaction(this.connection, tx, signer);
+        return {
+            transaction: tx,
+            message: `Checkpoint agent [${profile.toBase58()}]`,
+        };
+    }
+    async linkWallet(params) {
+        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 program = this.getProgram(authority);
+        const tx = new web3_js_1.Transaction();
+        const ix = await program.methods.linkWallet()
+            .accounts({
+            authority,
+            profile,
+            walletToLink,
+            walletLink,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .instruction();
+        tx.add(ix);
+        await finalizeTransaction(this.connection, tx, authority);
+        return {
+            transaction: tx,
+            message: `Link wallet ${walletToLink.toBase58()} to agent [${profile.toBase58()}]`,
+        };
+    }
+    async unlinkWallet(params) {
+        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 program = this.getProgram(authority);
+        const tx = new web3_js_1.Transaction();
+        const ix = await program.methods.unlinkWallet()
+            .accounts({
+            authority,
+            profile,
+            walletToUnlink,
+            walletLink,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .instruction();
+        tx.add(ix);
+        await finalizeTransaction(this.connection, tx, authority);
+        return {
+            transaction: tx,
+            message: `Unlink wallet ${walletToUnlink.toBase58()} from agent [${profile.toBase58()}]`,
+        };
+    }
+    async transferAuthority(params) {
+        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 program = this.getProgram(authority);
+        const tx = new web3_js_1.Transaction();
+        const ix = await program.methods.transferAuthority()
+            .accounts({ authority, profile, newAuthority })
+            .instruction();
+        tx.add(ix);
+        await finalizeTransaction(this.connection, tx, authority);
+        return {
+            transaction: tx,
+            message: `Transfer agent authority to ${newAuthority.toBase58()}`,
+        };
+    }
+}
+exports.RegistryProvider = RegistryProvider;

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

@@ -0,0 +1,42 @@
+/**
+ * Pyre Kit State Provider
+ *
+ * Objective game state tracking for an agent.
+ * Owns holdings, action counts, vault resolution, tick counter.
+ * Injected into ActionProvider so every action automatically updates state.
+ */
+import { Connection } from '@solana/web3.js';
+import type { State, AgentGameState, SerializedGameState, TrackedAction, CheckpointConfig } from '../types/state.types';
+import { RegistryProvider } from './registry.provider';
+export declare class StateProvider implements State {
+    private connection;
+    private publicKey;
+    private registry;
+    private _state;
+    private checkpointConfig;
+    private ticksSinceCheckpoint;
+    constructor(connection: Connection, publicKey: string, registry: RegistryProvider);
+    get state(): AgentGameState | null;
+    get vaultCreator(): string | null;
+    get initialized(): boolean;
+    get tick(): number;
+    /** Configure auto-checkpoint behavior */
+    setCheckpointConfig(config: CheckpointConfig): void;
+    init(): Promise<AgentGameState>;
+    record(action: TrackedAction, mint?: string, description?: string): Promise<void>;
+    /** Update sentiment score for a faction based on action type */
+    private updateSentiment;
+    /** Callback set by PyreKit to handle checkpoint triggers */
+    onCheckpointDue: (() => void) | null;
+    refreshHoldings(): Promise<void>;
+    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;
+    markRallied(mint: string): void;
+    serialize(): SerializedGameState;
+    hydrate(saved: SerializedGameState): void;
+}