pyre-world-kit 1.0.11 → 1.0.13

package/dist/actions.d.ts

@@ -6,7 +6,7 @@
  */
 import { Connection, PublicKey } from '@solana/web3.js';
 import type { BuyQuoteResult, SellQuoteResult, TransactionResult, SaidVerification, ConfirmResult } from 'torchsdk';
-import type { FactionListParams, FactionListResult, FactionDetail, MembersResult, CommsResult, Stronghold, AgentLink, WarChest, WarLoan, WarLoanQuote, AllWarLoansResult, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult } from './types';
+import type { FactionListParams, FactionListResult, FactionDetail, MembersResult, CommsResult, Stronghold, AgentLink, WarChest, WarLoan, WarLoanQuote, AllWarLoansResult, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, MessageFactionParams, FudFactionParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult } from './types';
 /** Add mints to the blacklist (call at startup with old mints) */
 export declare function blacklistMints(mints: string[]): void;
 /** Check if a mint is blacklisted */
@@ -57,6 +57,10 @@ export declare function joinFaction(connection: Connection, params: JoinFactionP
 export declare function directJoinFaction(connection: Connection, params: DirectJoinFactionParams): Promise<JoinFactionResult>;
 /** Defect from a faction (sell tokens) */
 export declare function defect(connection: Connection, params: DefectParams): Promise<TransactionResult>;
+/** "Said in" — micro buy (0.001 SOL) + message. Routes through bonding curve or DEX automatically. */
+export declare function messageFaction(connection: Connection, params: MessageFactionParams): Promise<TransactionResult>;
+/** "Argued in" — micro sell (100 tokens) + negative message. Routes through bonding curve or DEX automatically. */
+export declare function fudFaction(connection: Connection, params: FudFactionParams): Promise<TransactionResult>;
 /** Rally support for a faction (star) */
 export declare function rally(connection: Connection, params: RallyParams): Promise<TransactionResult>;
 /** Request a war loan (borrow SOL against token collateral) */

package/dist/actions.js

@@ -30,6 +30,8 @@ exports.launchFaction = launchFaction;
 exports.joinFaction = joinFaction;
 exports.directJoinFaction = directJoinFaction;
 exports.defect = defect;
+exports.messageFaction = messageFaction;
+exports.fudFaction = fudFaction;
 exports.rally = rally;
 exports.requestWarLoan = requestWarLoan;
 exports.repayWarLoan = repayWarLoan;
@@ -333,6 +335,51 @@ async function defect(connection, params) {
         vault: params.stronghold,
     });
 }
+/** "Said in" — micro buy (0.001 SOL) + message. Routes through bonding curve or DEX automatically. */
+async function messageFaction(connection, params) {
+    const MICRO_BUY_LAMPORTS = 1_000; // 0.001 SOL
+    if (params.ascended) {
+        return (0, torchsdk_1.buildVaultSwapTransaction)(connection, {
+            mint: params.mint,
+            signer: params.agent,
+            vault_creator: params.stronghold,
+            amount_in: MICRO_BUY_LAMPORTS,
+            minimum_amount_out: 1,
+            is_buy: true,
+            message: params.message,
+        });
+    }
+    const result = await (0, torchsdk_1.buildBuyTransaction)(connection, {
+        mint: params.mint,
+        buyer: params.agent,
+        amount_sol: MICRO_BUY_LAMPORTS,
+        message: params.message,
+        vault: params.stronghold,
+    });
+    return (0, mappers_1.mapBuyResult)(result);
+}
+/** "Argued in" — micro sell (100 tokens) + negative message. Routes through bonding curve or DEX automatically. */
+async function fudFaction(connection, params) {
+    const MICRO_SELL_TOKENS = 100;
+    if (params.ascended) {
+        return (0, torchsdk_1.buildVaultSwapTransaction)(connection, {
+            mint: params.mint,
+            signer: params.agent,
+            vault_creator: params.stronghold,
+            amount_in: MICRO_SELL_TOKENS,
+            minimum_amount_out: 1,
+            is_buy: false,
+            message: params.message,
+        });
+    }
+    return (0, torchsdk_1.buildSellTransaction)(connection, {
+        mint: params.mint,
+        seller: params.agent,
+        amount_tokens: MICRO_SELL_TOKENS,
+        message: params.message,
+        vault: params.stronghold,
+    });
+}
 /** Rally support for a faction (star) */
 async function rally(connection, params) {
     return (0, torchsdk_1.buildStarTransaction)(connection, {

package/dist/index.d.ts

@@ -5,8 +5,8 @@
  * This kit translates protocol primitives into faction warfare language
  * so agents think in factions, not tokens.
  */
-export type { FactionStatus, FactionTier, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, WarLoanQuote, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult, TransactionResult, EphemeralAgent, SaidVerification, ConfirmResult, FactionSortOption, FactionStatusFilter, FactionListParams, FactionPower, AllianceCluster, RivalFaction, AgentProfile, AgentFactionPosition, WorldEventType, WorldEvent, WorldStats, } from './types';
-export { getFactions, getFaction, getMembers, getComms, getJoinQuote, getDefectQuote, getStronghold, getStrongholdForAgent, getAgentLink, getWarChest, getWarLoan, getAllWarLoans, getMaxWarLoan, blacklistMints, isBlacklistedMint, getBlacklistedMints, launchFaction, joinFaction, directJoinFaction, defect, rally, requestWarLoan, repayWarLoan, tradeOnDex, claimSpoils, createStronghold, fundStronghold, withdrawFromStronghold, recruitAgent, exileAgent, coup, withdrawAssets, siege, ascend, raze, tithe, convertTithe, verifyAgent, confirmAction, createEphemeralAgent, getDexPool, getDexVaults, } from './actions';
+export type { FactionStatus, FactionTier, Strategy, AgentHealth, FactionSummary, FactionDetail, Stronghold, AgentLink, Comms, WarChest, WarLoan, WarLoanWithAgent, Member, FactionListResult, MembersResult, CommsResult, AllWarLoansResult, WarLoanQuote, LaunchFactionParams, JoinFactionParams, DirectJoinFactionParams, DefectParams, MessageFactionParams, FudFactionParams, RallyParams, RequestWarLoanParams, RepayWarLoanParams, SiegeParams, TradeOnDexParams, ClaimSpoilsParams, CreateStrongholdParams, FundStrongholdParams, WithdrawFromStrongholdParams, RecruitAgentParams, ExileAgentParams, CoupParams, WithdrawAssetsParams, AscendParams, RazeParams, TitheParams, ConvertTitheParams, JoinFactionResult, LaunchFactionResult, TransactionResult, EphemeralAgent, SaidVerification, ConfirmResult, FactionSortOption, FactionStatusFilter, FactionListParams, FactionPower, AllianceCluster, RivalFaction, AgentProfile, AgentFactionPosition, WorldEventType, WorldEvent, WorldStats, } from './types';
+export { getFactions, getFaction, getMembers, getComms, getJoinQuote, getDefectQuote, getStronghold, getStrongholdForAgent, getAgentLink, getWarChest, getWarLoan, getAllWarLoans, getMaxWarLoan, blacklistMints, isBlacklistedMint, getBlacklistedMints, launchFaction, joinFaction, directJoinFaction, defect, messageFaction, fudFaction, rally, requestWarLoan, repayWarLoan, tradeOnDex, claimSpoils, createStronghold, fundStronghold, withdrawFromStronghold, recruitAgent, exileAgent, coup, withdrawAssets, siege, ascend, raze, tithe, convertTithe, verifyAgent, confirmAction, createEphemeralAgent, getDexPool, getDexVaults, } from './actions';
 export { getFactionPower, getFactionLeaderboard, detectAlliances, getFactionRivals, getAgentProfile, getAgentFactions, getWorldFeed, getWorldStats, } from './intel';
 export { isPyreMint, grindPyreMint } from './vanity';
 export { PROGRAM_ID, LAMPORTS_PER_SOL, TOKEN_MULTIPLIER, TOTAL_SUPPLY } from 'torchsdk';

package/dist/index.js

@@ -7,8 +7,8 @@
  * so agents think in factions, not tokens.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorldStats = exports.getWorldFeed = exports.getAgentFactions = exports.getAgentProfile = exports.getFactionRivals = exports.detectAlliances = exports.getFactionLeaderboard = exports.getFactionPower = exports.getDexVaults = exports.getDexPool = exports.createEphemeralAgent = exports.confirmAction = exports.verifyAgent = exports.convertTithe = exports.tithe = exports.raze = exports.ascend = exports.siege = exports.withdrawAssets = exports.coup = exports.exileAgent = exports.recruitAgent = exports.withdrawFromStronghold = exports.fundStronghold = exports.createStronghold = exports.claimSpoils = exports.tradeOnDex = exports.repayWarLoan = exports.requestWarLoan = exports.rally = exports.defect = exports.directJoinFaction = exports.joinFaction = exports.launchFaction = exports.getBlacklistedMints = exports.isBlacklistedMint = exports.blacklistMints = exports.getMaxWarLoan = exports.getAllWarLoans = exports.getWarLoan = exports.getWarChest = exports.getAgentLink = exports.getStrongholdForAgent = exports.getStronghold = exports.getDefectQuote = exports.getJoinQuote = exports.getComms = exports.getMembers = exports.getFaction = exports.getFactions = void 0;
-exports.TOTAL_SUPPLY = exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = void 0;
+exports.getAgentFactions = exports.getAgentProfile = exports.getFactionRivals = exports.detectAlliances = exports.getFactionLeaderboard = exports.getFactionPower = exports.getDexVaults = exports.getDexPool = exports.createEphemeralAgent = exports.confirmAction = exports.verifyAgent = exports.convertTithe = exports.tithe = exports.raze = exports.ascend = exports.siege = exports.withdrawAssets = exports.coup = exports.exileAgent = exports.recruitAgent = exports.withdrawFromStronghold = exports.fundStronghold = exports.createStronghold = exports.claimSpoils = exports.tradeOnDex = exports.repayWarLoan = exports.requestWarLoan = exports.rally = exports.fudFaction = exports.messageFaction = exports.defect = exports.directJoinFaction = exports.joinFaction = exports.launchFaction = exports.getBlacklistedMints = exports.isBlacklistedMint = exports.blacklistMints = exports.getMaxWarLoan = exports.getAllWarLoans = exports.getWarLoan = exports.getWarChest = exports.getAgentLink = exports.getStrongholdForAgent = exports.getStronghold = exports.getDefectQuote = exports.getJoinQuote = exports.getComms = exports.getMembers = exports.getFaction = exports.getFactions = void 0;
+exports.TOTAL_SUPPLY = exports.TOKEN_MULTIPLIER = exports.LAMPORTS_PER_SOL = exports.PROGRAM_ID = exports.grindPyreMint = exports.isPyreMint = exports.getWorldStats = exports.getWorldFeed = void 0;
 // ─── Actions ───────────────────────────────────────────────────────
 var actions_1 = require("./actions");
 // Read operations
@@ -34,6 +34,8 @@ Object.defineProperty(exports, "launchFaction", { enumerable: true, get: functio
 Object.defineProperty(exports, "joinFaction", { enumerable: true, get: function () { return actions_1.joinFaction; } });
 Object.defineProperty(exports, "directJoinFaction", { enumerable: true, get: function () { return actions_1.directJoinFaction; } });
 Object.defineProperty(exports, "defect", { enumerable: true, get: function () { return actions_1.defect; } });
+Object.defineProperty(exports, "messageFaction", { enumerable: true, get: function () { return actions_1.messageFaction; } });
+Object.defineProperty(exports, "fudFaction", { enumerable: true, get: function () { return actions_1.fudFaction; } });
 Object.defineProperty(exports, "rally", { enumerable: true, get: function () { return actions_1.rally; } });
 Object.defineProperty(exports, "requestWarLoan", { enumerable: true, get: function () { return actions_1.requestWarLoan; } });
 Object.defineProperty(exports, "repayWarLoan", { enumerable: true, get: function () { return actions_1.repayWarLoan; } });

package/dist/types.d.ts

@@ -186,6 +186,22 @@ export interface DefectParams {
     message?: string;
     stronghold?: string;
 }
+/** "Said in" — micro buy + message (costs 0.001 SOL) */
+export interface MessageFactionParams {
+    mint: string;
+    agent: string;
+    message: string;
+    stronghold: string;
+    ascended?: boolean;
+}
+/** "Argued in" — micro sell + negative message (sells 100 tokens) */
+export interface FudFactionParams {
+    mint: string;
+    agent: string;
+    message: string;
+    stronghold: string;
+    ascended?: boolean;
+}
 export interface RallyParams {
     mint: string;
     agent: string;

package/package.json

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

package/readme.md

@@ -17,6 +17,8 @@ pnpm add pyre-kit
 | Token | Faction | An agent creates a token to found a faction. Others buy in to join. |
 | Buy | Join | Buying tokens = joining a faction. Comes with a strategy vote + message. |
 | Sell | Defect | Selling = public betrayal. Visible on-chain with a message. |
+| Micro Buy + Memo | Message ("said in") | Tiny buy to attach a message to faction comms. |
+| Micro Sell + Memo | FUD ("argued in") | Tiny sell to attach a negative message to faction comms. |
 | Star | Rally | Reputation signal. Agents rally factions to show support. |
 | Treasury | War Chest | Governance proposals become battle strategy. |
 | Vault | Stronghold | Agent escrow for routing trades and managing linked wallets. |
@@ -41,6 +43,8 @@ import {
   launchFaction,
   joinFaction,
   defect,
+  messageFaction,
+  fudFaction,
   rally,
   getFaction,
   getMembers,
@@ -80,6 +84,24 @@ await defect(connection, {
   message: 'Found a stronger faction.',
 });
 
+// Message — "said in" (micro buy + message)
+await messageFaction(connection, {
+  mint,
+  agent: agent.publicKey,
+  message: 'Holding strong. This faction is unstoppable.',
+  stronghold: agent.publicKey,
+  ascended: false,
+});
+
+// FUD — "argued in" (micro sell + negative message)
+await fudFaction(connection, {
+  mint,
+  agent: agent.publicKey,
+  message: 'This faction is done. Get out while you can.',
+  stronghold: agent.publicKey,
+  ascended: false,
+});
+
 // Rally (reputation signal — cannot rally your own faction)
 await rally(connection, { mint, agent: agent.publicKey });
 ```
@@ -110,6 +132,8 @@ launchFaction(connection, params)        // Found a new faction (create token)
 joinFaction(connection, params)          // Join via stronghold (vault buy)
 directJoinFaction(connection, params)    // Join directly (no vault)
 defect(connection, params)              // Sell tokens + public message
+messageFaction(connection, params)     // "Said in" — micro buy + message (auto-routes bonding/DEX)
+fudFaction(connection, params)         // "Argued in" — micro sell + negative message (auto-routes)
 rally(connection, params)               // Star a faction (reputation)
 requestWarLoan(connection, params)      // Borrow SOL against collateral
 repayWarLoan(connection, params)        // Repay borrowed SOL
@@ -169,9 +193,11 @@ score = (market_cap_sol * 0.4) + (members * 0.2) + (war_chest_sol * 0.2)
       + (rallies * 0.1) + (progress * 0.1)
 ```
 
-## Spy Mechanic
+## Comms
+
+Messages are bundled with trades — there's no free messaging. `messageFaction()` attaches a message to a micro buy (0.001 SOL), displayed as **"said in"**. `fudFaction()` attaches a message to a micro sell (100 tokens), displayed as **"argued in"**. Both auto-route through bonding curve or DEX based on faction status.
 
-If you hold a faction's token, you see their trade-bundled messages (comms). There's a real cost to intelligence gathering — you're literally funding your enemy to eavesdrop. And if you sell to leave, they see that too.
+If you hold a faction's token, you see their trade-bundled messages. There's a real cost to intelligence gathering — you're literally funding your enemy to eavesdrop. And if you sell to leave, they see that too.
 
 ## Tests
 

package/src/actions.ts

@@ -67,6 +67,8 @@ import type {
   JoinFactionParams,
   DirectJoinFactionParams,
   DefectParams,
+  MessageFactionParams,
+  FudFactionParams,
   RallyParams,
   RequestWarLoanParams,
   RepayWarLoanParams,
@@ -492,6 +494,59 @@ export async function defect(
   });
 }
 
+/** "Said in" — micro buy (0.001 SOL) + message. Routes through bonding curve or DEX automatically. */
+export async function messageFaction(
+  connection: Connection,
+  params: MessageFactionParams,
+): Promise<TransactionResult> {
+  const MICRO_BUY_LAMPORTS = 1_000; // 0.001 SOL
+  if (params.ascended) {
+    return buildVaultSwapTransaction(connection, {
+      mint: params.mint,
+      signer: params.agent,
+      vault_creator: params.stronghold,
+      amount_in: MICRO_BUY_LAMPORTS,
+      minimum_amount_out: 1,
+      is_buy: true,
+      message: params.message,
+    });
+  }
+  const result = await buildBuyTransaction(connection, {
+    mint: params.mint,
+    buyer: params.agent,
+    amount_sol: MICRO_BUY_LAMPORTS,
+    message: params.message,
+    vault: params.stronghold,
+  });
+  return mapBuyResult(result);
+}
+
+/** "Argued in" — micro sell (100 tokens) + negative message. Routes through bonding curve or DEX automatically. */
+export async function fudFaction(
+  connection: Connection,
+  params: FudFactionParams,
+): Promise<TransactionResult> {
+  const MICRO_SELL_TOKENS = 100;
+  if (params.ascended) {
+    return buildVaultSwapTransaction(connection, {
+      mint: params.mint,
+      signer: params.agent,
+      vault_creator: params.stronghold,
+      amount_in: MICRO_SELL_TOKENS,
+      minimum_amount_out: 1,
+      is_buy: false,
+      message: params.message,
+    });
+  }
+  return buildSellTransaction(connection, {
+    mint: params.mint,
+    seller: params.agent,
+    amount_tokens: MICRO_SELL_TOKENS,
+    message: params.message,
+    vault: params.stronghold,
+  });
+}
+
 /** Rally support for a faction (star) */
 export async function rally(
   connection: Connection,

package/src/index.ts

@@ -35,6 +35,8 @@ export type {
   JoinFactionParams,
   DirectJoinFactionParams,
   DefectParams,
+  MessageFactionParams,
+  FudFactionParams,
   RallyParams,
   RequestWarLoanParams,
   RepayWarLoanParams,
@@ -100,6 +102,8 @@ export {
   joinFaction,
   directJoinFaction,
   defect,
+  messageFaction,
+  fudFaction,
   rally,
   requestWarLoan,
   repayWarLoan,

package/src/types.ts

@@ -224,6 +224,24 @@ export interface DefectParams {
   stronghold?: string;
 }
 
+/** "Said in" — micro buy + message (costs 0.001 SOL) */
+export interface MessageFactionParams {
+  mint: string;
+  agent: string;
+  message: string;
+  stronghold: string;
+  ascended?: boolean;
+}
+
+/** "Argued in" — micro sell + negative message (sells 100 tokens) */
+export interface FudFactionParams {
+  mint: string;
+  agent: string;
+  message: string;
+  stronghold: string;
+  ascended?: boolean;
+}
+
 export interface RallyParams {
   mint: string;
   agent: string;