pyre-world-kit 2.0.11 → 3.0.0

package/src/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"
           }
         ]
@@ -706,4 +511,4 @@
       }
     }
   ]
-}
+}

package/src/types/action.types.ts

@@ -0,0 +1,76 @@
+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/src/types/intel.types.ts

@@ -0,0 +1,22 @@
+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/src/types/mapper.types.ts

@@ -0,0 +1,84 @@
+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 const STATUS_MAP: Record<TokenStatus, FactionStatus> = {
+  bonding: 'rising',
+  complete: 'ready',
+  migrated: 'ascended',
+  reclaimed: 'razed',
+}
+
+export const STATUS_REVERSE: Record<FactionStatus, TokenStatus> = {
+  rising: 'bonding',
+  ready: 'complete',
+  ascended: 'migrated',
+  razed: 'reclaimed',
+}
+
+export const STATUS_FILTER_REVERSE: Record<FactionStatusFilter, TokenStatusFilter> = {
+  rising: 'bonding',
+  ready: 'complete',
+  ascended: 'migrated',
+  razed: 'reclaimed',
+  all: 'all',
+}