pyre-world-kit 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,353 @@
+/**
+ * Pyre Kit Types
+ *
+ * Game-semantic wrappers over torchsdk types.
+ * Torch Market IS the game engine — these types translate
+ * protocol primitives into faction warfare language.
+ */
+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';
+/** Agent loan health status */
+export type AgentHealth = 'healthy' | 'at_risk' | 'liquidatable' | 'none';
+/** Summary view of a faction (wraps TokenSummary) */
+export interface FactionSummary {
+    mint: string;
+    name: string;
+    symbol: string;
+    status: FactionStatus;
+    tier: FactionTier;
+    price_sol: number;
+    market_cap_sol: number;
+    progress_percent: number;
+    members: number | null;
+    created_at: number;
+    last_activity_at: number;
+}
+/** Detailed view of a faction (wraps TokenDetail) */
+export interface FactionDetail {
+    mint: string;
+    name: string;
+    symbol: string;
+    description?: string;
+    image?: string;
+    status: FactionStatus;
+    tier: FactionTier;
+    price_sol: number;
+    price_usd?: number;
+    market_cap_sol: number;
+    market_cap_usd?: number;
+    progress_percent: number;
+    sol_raised: number;
+    sol_target: number;
+    total_supply: number;
+    circulating_supply: number;
+    tokens_in_curve: number;
+    tokens_in_vote_vault: number;
+    tokens_burned: number;
+    war_chest_sol: number;
+    war_chest_tokens: number;
+    total_bought_back: number;
+    buyback_count: number;
+    votes_scorched_earth: number;
+    votes_fortify: number;
+    founder: string;
+    members: number | null;
+    rallies: number;
+    created_at: number;
+    last_activity_at: number;
+    twitter?: string;
+    telegram?: string;
+    website?: string;
+    founder_verified?: boolean;
+    founder_trust_tier?: 'high' | 'medium' | 'low' | null;
+    founder_said_name?: string;
+    founder_badge_url?: string;
+    warnings?: string[];
+}
+/** Agent stronghold (wraps VaultInfo) */
+export interface Stronghold {
+    address: string;
+    creator: string;
+    authority: string;
+    sol_balance: number;
+    total_deposited: number;
+    total_withdrawn: number;
+    total_spent: number;
+    total_received: number;
+    linked_agents: number;
+    created_at: number;
+}
+/** Agent wallet link (wraps VaultWalletLinkInfo) */
+export interface AgentLink {
+    address: string;
+    stronghold: string;
+    wallet: string;
+    linked_at: number;
+}
+/** Faction communication (wraps TokenMessage) */
+export interface Comms {
+    signature: string;
+    memo: string;
+    sender: string;
+    timestamp: number;
+    sender_verified?: boolean;
+    sender_trust_tier?: 'high' | 'medium' | 'low' | null;
+    sender_said_name?: string;
+    sender_badge_url?: string;
+}
+/** War chest lending info (wraps LendingInfo) */
+export interface WarChest {
+    interest_rate_bps: number;
+    max_ltv_bps: number;
+    liquidation_threshold_bps: number;
+    liquidation_bonus_bps: number;
+    utilization_cap_bps: number;
+    borrow_share_multiplier: number;
+    total_sol_lent: number | null;
+    active_loans: number | null;
+    war_chest_sol_available: number;
+    warnings?: string[];
+}
+/** War loan position (wraps LoanPositionInfo) */
+export interface WarLoan {
+    collateral_amount: number;
+    borrowed_amount: number;
+    accrued_interest: number;
+    total_owed: number;
+    collateral_value_sol: number | null;
+    current_ltv_bps: number | null;
+    health: AgentHealth;
+    warnings?: string[];
+}
+/** War loan with borrower key (wraps LoanPositionWithKey) */
+export interface WarLoanWithAgent extends WarLoan {
+    borrower: string;
+}
+/** Faction member (wraps Holder) */
+export interface Member {
+    address: string;
+    balance: number;
+    percentage: number;
+}
+export interface FactionListResult {
+    factions: FactionSummary[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface MembersResult {
+    members: Member[];
+    total_members: number;
+}
+export interface CommsResult {
+    comms: Comms[];
+    total: number;
+}
+export interface AllWarLoansResult {
+    positions: WarLoanWithAgent[];
+    pool_price_sol: number | null;
+}
+export interface LaunchFactionParams {
+    founder: string;
+    name: string;
+    symbol: string;
+    metadata_uri: string;
+    sol_target?: number;
+    community_faction?: boolean;
+}
+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;
+}
+export interface DefectParams {
+    mint: string;
+    agent: string;
+    amount_tokens: number;
+    slippage_bps?: number;
+    message?: string;
+    stronghold?: string;
+}
+export interface RallyParams {
+    mint: string;
+    agent: string;
+    stronghold?: string;
+}
+export interface RequestWarLoanParams {
+    mint: string;
+    borrower: string;
+    collateral_amount: number;
+    sol_to_borrow: number;
+    stronghold?: string;
+}
+export interface RepayWarLoanParams {
+    mint: string;
+    borrower: string;
+    sol_amount: number;
+    stronghold?: string;
+}
+export interface SiegeParams {
+    mint: string;
+    liquidator: string;
+    borrower: string;
+    stronghold?: string;
+}
+export interface TradeOnDexParams {
+    mint: string;
+    signer: string;
+    stronghold_creator: string;
+    amount_in: number;
+    minimum_amount_out: number;
+    is_buy: boolean;
+}
+export interface ClaimSpoilsParams {
+    agent: string;
+    stronghold?: string;
+}
+export interface CreateStrongholdParams {
+    creator: string;
+}
+export interface FundStrongholdParams {
+    depositor: string;
+    stronghold_creator: string;
+    amount_sol: number;
+}
+export interface WithdrawFromStrongholdParams {
+    authority: string;
+    stronghold_creator: string;
+    amount_sol: number;
+}
+export interface RecruitAgentParams {
+    authority: string;
+    stronghold_creator: string;
+    wallet_to_link: string;
+}
+export interface ExileAgentParams {
+    authority: string;
+    stronghold_creator: string;
+    wallet_to_unlink: string;
+}
+export interface CoupParams {
+    authority: string;
+    stronghold_creator: string;
+    new_authority: string;
+}
+export interface WithdrawAssetsParams {
+    authority: string;
+    stronghold_creator: string;
+    mint: string;
+    destination: string;
+    amount: number;
+}
+export interface AscendParams {
+    mint: string;
+    payer: string;
+}
+export interface RazeParams {
+    payer: string;
+    mint: string;
+}
+export interface TitheParams {
+    mint: string;
+    payer: string;
+    sources?: string[];
+}
+export interface ConvertTitheParams {
+    mint: string;
+    payer: string;
+    minimum_amount_out?: number;
+    harvest?: boolean;
+    sources?: string[];
+}
+/** Re-export base result types with game names */
+export type { TransactionResult, CreateTokenResult, EphemeralAgent, SaidVerification, ConfirmResult };
+export interface JoinFactionResult extends TransactionResult {
+    migrationTransaction?: Transaction;
+}
+export interface LaunchFactionResult extends TransactionResult {
+    mint: PublicKey;
+    mintKeypair: Keypair;
+}
+export type FactionSortOption = TokenSortOption;
+export type FactionStatusFilter = 'rising' | 'ready' | 'ascended' | 'razed' | 'all';
+export interface FactionListParams {
+    limit?: number;
+    offset?: number;
+    status?: FactionStatusFilter;
+    sort?: FactionSortOption;
+}
+export interface FactionPower {
+    mint: string;
+    name: string;
+    symbol: string;
+    score: number;
+    market_cap_sol: number;
+    members: number;
+    war_chest_sol: number;
+    rallies: number;
+    progress_percent: number;
+    status: FactionStatus;
+}
+export interface AllianceCluster {
+    factions: string[];
+    shared_members: number;
+    overlap_percent: number;
+}
+export interface RivalFaction {
+    mint: string;
+    name: string;
+    symbol: string;
+    defections_in: number;
+    defections_out: number;
+}
+export interface AgentProfile {
+    wallet: string;
+    stronghold: Stronghold | null;
+    factions_joined: AgentFactionPosition[];
+    factions_founded: string[];
+    said_verification: SaidVerification | null;
+    total_value_sol: number;
+}
+export interface AgentFactionPosition {
+    mint: string;
+    name: string;
+    symbol: string;
+    balance: number;
+    percentage: number;
+    value_sol: number;
+}
+export interface WorldEvent {
+    type: 'launch' | 'join' | 'defect' | 'rally' | 'ascend' | 'raze';
+    faction_mint: string;
+    faction_name: string;
+    agent?: string;
+    amount_sol?: number;
+    timestamp: number;
+    signature?: string;
+    message?: string;
+}
+export interface WorldStats {
+    total_factions: number;
+    rising_factions: number;
+    ascended_factions: number;
+    total_sol_locked: number;
+    most_powerful: FactionPower | null;
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Pyre Kit Types
+ *
+ * Game-semantic wrappers over torchsdk types.
+ * Torch Market IS the game engine — these types translate
+ * protocol primitives into faction warfare language.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/vanity.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pyre vanity mint address grinder
+ *
+ * Grinds for Solana keypairs whose base58 address ends with "pyre".
+ * This is how we distinguish pyre faction tokens from regular torch tokens —
+ * no registry program needed, just check the mint suffix.
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import type { CreateTokenResult, CreateTokenParams } from 'torchsdk';
+/** Grind for a keypair whose base58 address ends with "py" */
+export declare function 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>;

package/dist/vanity.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Pyre vanity mint address grinder
+ *
+ * Grinds for Solana keypairs whose base58 address ends with "pyre".
+ * This is how we distinguish pyre faction tokens from regular torch tokens —
+ * no registry program needed, just check the mint suffix.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.grindPyreMint = grindPyreMint;
+exports.isPyreMint = isPyreMint;
+exports.buildCreateFactionTransaction = buildCreateFactionTransaction;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const anchor_1 = require("@coral-xyz/anchor");
+const torchsdk_1 = require("torchsdk");
+// Token-2022 program ID
+const TOKEN_2022_PROGRAM_ID = new web3_js_1.PublicKey('TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb');
+// PDA seeds (must match the Rust program)
+const GLOBAL_CONFIG_SEED = 'global_config';
+const BONDING_CURVE_SEED = 'bonding_curve';
+const TREASURY_SEED = 'treasury';
+const TREASURY_LOCK_SEED = 'treasury_lock';
+// IDL loaded from torchsdk dist
+const torch_market_json_1 = __importDefault(require("torchsdk/dist/torch_market.json"));
+// ── PDA helpers (copied from torchsdk internals) ──
+const getGlobalConfigPda = () => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(GLOBAL_CONFIG_SEED)], torchsdk_1.PROGRAM_ID);
+const getBondingCurvePda = (mint) => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(BONDING_CURVE_SEED), mint.toBuffer()], torchsdk_1.PROGRAM_ID);
+const getTokenTreasuryPda = (mint) => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(TREASURY_SEED), mint.toBuffer()], torchsdk_1.PROGRAM_ID);
+const getTreasuryTokenAccount = (mint, treasury) => (0, spl_token_1.getAssociatedTokenAddressSync)(mint, treasury, true, TOKEN_2022_PROGRAM_ID);
+const getTreasuryLockPda = (mint) => web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(TREASURY_LOCK_SEED), mint.toBuffer()], torchsdk_1.PROGRAM_ID);
+const getTreasuryLockTokenAccount = (mint, treasuryLock) => (0, spl_token_1.getAssociatedTokenAddressSync)(mint, treasuryLock, true, TOKEN_2022_PROGRAM_ID);
+const makeDummyProvider = (connection, payer) => {
+    const dummyWallet = {
+        publicKey: payer,
+        signTransaction: async (t) => t,
+        signAllTransactions: async (t) => t,
+    };
+    return new anchor_1.AnchorProvider(connection, dummyWallet, {});
+};
+const finalizeTransaction = async (connection, tx, feePayer) => {
+    const { blockhash } = await connection.getLatestBlockhash();
+    tx.recentBlockhash = blockhash;
+    tx.feePayer = feePayer;
+};
+// ── Vanity grinder ──
+const PYRE_SUFFIX = 'py';
+/** Grind for a keypair whose base58 address ends with "py" */
+function 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)) {
+            return kp;
+        }
+    }
+    // Fallback — return last generated keypair (should be extremely rare)
+    return web3_js_1.Keypair.generate();
+}
+/** Check if a mint address is a pyre faction (ends with "py") */
+function isPyreMint(mint) {
+    return mint.endsWith(PYRE_SUFFIX);
+}
+// ── 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 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();
+    // Derive PDAs
+    const [globalConfig] = getGlobalConfigPda();
+    const [bondingCurve] = getBondingCurvePda(mint.publicKey);
+    const [treasury] = getTokenTreasuryPda(mint.publicKey);
+    const bondingCurveTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint.publicKey, bondingCurve, true, TOKEN_2022_PROGRAM_ID);
+    const treasuryTokenAccount = getTreasuryTokenAccount(mint.publicKey, treasury);
+    const [treasuryLock] = getTreasuryLockPda(mint.publicKey);
+    const treasuryLockTokenAccount = getTreasuryLockTokenAccount(mint.publicKey, treasuryLock);
+    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 })
+        .accounts({
+        creator,
+        globalConfig,
+        mint: mint.publicKey,
+        bondingCurve,
+        tokenVault: bondingCurveTokenAccount,
+        treasury,
+        treasuryTokenAccount,
+        treasuryLock,
+        treasuryLockTokenAccount,
+        token2022Program: TOKEN_2022_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+        rent: web3_js_1.SYSVAR_RENT_PUBKEY,
+    })
+        .instruction();
+    tx.add(createIx);
+    await finalizeTransaction(connection, tx, creator);
+    // Partially sign with mint keypair
+    tx.partialSign(mint);
+    return {
+        transaction: tx,
+        mint: mint.publicKey,
+        mintKeypair: mint,
+        message: `Create faction "${name}" ($${symbol}) [pyre:${mint.publicKey.toBase58()}]`,
+    };
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "pyre-world-kit",
+  "version": "1.0.0",
+  "description": "Agent-first faction warfare kit — game-semantic wrapper over torchsdk",
+    "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "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"
+  },
+  "dependencies": {
+    "torchsdk": "^3.7.30",
+    "@solana/web3.js": "^1.98.4",
+    "@solana/spl-token": "^0.4.6",
+    "@coral-xyz/anchor": "^0.32.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.9.3",
+    "tsx": "^4.19.4"
+  },
+  "packageManager": "pnpm@9.10.0+sha512.73a29afa36a0d092ece5271de5177ecbf8318d454ecd701343131b8ebc0c1a91c487da46ab77c8e596d6acf1461e3594ced4becedf8921b074fbd8653ed7051c"
+}