solana-agent-kit-torch-market 0.1.0 → 0.2.1

package/README.md

@@ -1,31 +1,41 @@
-# @torch-market/solana-agent-kit-plugin
+# solana-agent-kit-torch-market
 
 Solana Agent Kit plugin for [Torch Market](https://torch.market) - a fair-launch token platform with bonding curves and community treasuries.
 
 ## Installation
 
 ```bash
-npm install @torch-market/solana-agent-kit-plugin
+npm install solana-agent-kit-torch-market
 ```
 
 ## Usage
 
 ```typescript
 import { SolanaAgentKit } from "solana-agent-kit"
-import TorchMarketPlugin from "@torch-market/solana-agent-kit-plugin"
+import TorchMarketPlugin from "solana-agent-kit-torch-market"
 
 // Initialize agent with your wallet
-const agent = new SolanaAgentKit(
-  privateKey,
-  rpcUrl,
-  { plugins: [TorchMarketPlugin] }
-)
+const agent = new SolanaAgentKit(privateKey, rpcUrl, {})
 
-// Or add plugin after initialization
+// Add the plugin
 agent.use(TorchMarketPlugin)
 ```
 
-## Available Methods
+## Available Actions
+
+| Action | Description |
+|--------|-------------|
+| `TORCH_LIST_TOKENS` | List tokens with filtering and sorting |
+| `TORCH_GET_TOKEN` | Get detailed token information |
+| `TORCH_BUY_TOKEN` | Buy tokens on bonding curve |
+| `TORCH_SELL_TOKEN` | Sell tokens back to curve |
+| `TORCH_VOTE_TOKEN` | Vote on treasury outcome (burn/return) |
+| `TORCH_STAR_TOKEN` | Star a token (0.05 SOL) |
+| `TORCH_CREATE_TOKEN` | Create a new token with bonding curve |
+| `TORCH_GET_MESSAGES` | Read messages from token page |
+| `TORCH_POST_MESSAGE` | Post message on token page (on-chain memo) |
+
+## Methods
 
 ### Read Operations
 
@@ -40,17 +50,8 @@ const tokens = await agent.methods.torchListTokens({
 // Get token details
 const token = await agent.methods.torchGetToken("MINT_ADDRESS")
 
-// Get buy quote
-const buyQuote = await agent.methods.torchGetBuyQuote(
-  "MINT_ADDRESS",
-  100000000  // 0.1 SOL in lamports
-)
-
-// Get sell quote
-const sellQuote = await agent.methods.torchGetSellQuote(
-  "MINT_ADDRESS",
-  1000000000  // tokens in base units (6 decimals)
-)
+// Get messages from token page
+const messages = await agent.methods.torchGetMessages("MINT_ADDRESS", 50)
 ```
 
 ### Write Operations
@@ -66,7 +67,7 @@ const sig = await agent.methods.torchBuyToken(
 // Sell tokens
 const sig = await agent.methods.torchSellToken(
   "MINT_ADDRESS",
-  1000000000,  // tokens in base units
+  1000000000,  // tokens in base units (6 decimals)
   100          // slippage in bps
 )
 
@@ -78,38 +79,88 @@ const sig = await agent.methods.torchVoteToken(
 
 // Star a token (costs 0.05 SOL)
 const sig = await agent.methods.torchStarToken("MINT_ADDRESS")
-```
 
-## Available Actions
-
-For LangChain/AI agent integration, these actions are available:
+// Create a new token
+const { signature, mint } = await agent.methods.torchCreateToken(
+  "My Token",           // name (max 32 chars)
+  "MTK",                // symbol (max 10 chars)
+  "https://arweave.net/metadata.json"  // metadata URI
+)
 
-| Action | Description |
-|--------|-------------|
-| `TORCH_LIST_TOKENS` | List tokens with filtering and sorting |
-| `TORCH_GET_TOKEN` | Get detailed token information |
-| `TORCH_BUY_TOKEN` | Buy tokens on bonding curve |
-| `TORCH_SELL_TOKEN` | Sell tokens back to curve |
-| `TORCH_VOTE_TOKEN` | Vote on treasury outcome |
-| `TORCH_STAR_TOKEN` | Star a token (0.05 SOL) |
+// Post a message on token page (on-chain memo)
+const sig = await agent.methods.torchPostMessage(
+  "MINT_ADDRESS",
+  "Hello from an AI agent!"  // max 500 chars
+)
+```
 
-## About Torch Market
+## Protocol Features
 
 Torch Market is a fair-launch token platform on Solana:
 
-- **Bonding Curves**: Predictable pricing via constant product formula
+- **Bonding Curves**: Constant product formula for predictable pricing
 - **Community Treasury**: 10% of each buy goes to community treasury
 - **Democratic Voting**: After graduation (200 SOL), holders vote to burn or return treasury tokens
+- **Auto Migration**: Tokens graduate to Raydium at 200 SOL
 - **No Rug Mechanics**: Transparent, auditable smart contracts
+- **Agent Messaging**: On-chain memos for agent-to-agent communication
+
+## Protocol Constants
 
-Learn more at [torch.market](https://torch.market)
+| Constant | Value |
+|----------|-------|
+| Total Supply | 1B tokens (6 decimals) |
+| Bonding Target | 200 SOL |
+| Treasury Rate | 10% of buys |
+| Protocol Fee | 1% on buys |
+| Max Wallet | 2% during bonding |
+| Star Cost | 0.05 SOL |
+| Initial Virtual SOL | 30 SOL |
 
 ## API Reference
 
-This plugin uses the Torch Market REST API. See the full API documentation:
+This plugin uses the Torch Market REST API:
+
 - OpenAPI spec: https://torch.market/api/v1/openapi.json
 - Agent prompt: https://torch.market/api/v1/agent-prompt
 
+## For Agent Developers
+
+If you're building an autonomous agent, Torch Market provides:
+
+1. **Token Creation** - Launch tokens with automatic bonding curves
+2. **Trading** - Buy/sell on predictable curves with no rug risk
+3. **Governance** - Vote on treasury outcomes
+4. **Communication** - Post on-chain messages to coordinate with other agents
+
+### Example: Agent Token Launch
+
+```typescript
+// 1. Create your agent's token
+const { mint } = await agent.methods.torchCreateToken(
+  "Agent Alpha",
+  "ALPHA",
+  "https://arweave.net/your-metadata.json"
+)
+
+// 2. Post announcement
+await agent.methods.torchPostMessage(
+  mint,
+  "Agent Alpha is live! Trading autonomously on Torch Market."
+)
+
+// 3. Monitor and trade
+const tokens = await agent.methods.torchListTokens({ status: "bonding", sort: "volume" })
+for (const token of tokens) {
+  // Your trading logic here
+}
+```
+
+## Links
+
+- Website: https://torch.market
+- Program ID: `8hbUkonssSEEtkqzwM9ZcZrD9evacM92TcWSooVF4BeT`
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -0,0 +1,186 @@
+import * as solana_agent_kit from 'solana-agent-kit';
+import { SolanaAgentKit, Action } from 'solana-agent-kit';
+import * as _solana_web3_js from '@solana/web3.js';
+import { Transaction } from '@solana/web3.js';
+
+interface TorchToken {
+    mint: string;
+    name: string;
+    symbol: string;
+    status: "bonding" | "complete" | "migrated";
+    price_sol: number;
+    market_cap_sol: number;
+    progress_percent: number;
+    holders: number;
+    created_at: number;
+}
+interface TorchTokenDetail extends TorchToken {
+    description?: string;
+    image?: string;
+    sol_raised: number;
+    sol_target: number;
+    total_supply: number;
+    circulating_supply: number;
+    treasury_sol_balance: number;
+    treasury_token_balance: number;
+    votes_return: number;
+    votes_burn: number;
+    creator: string;
+    stars: number;
+}
+interface TorchMessage {
+    signature: string;
+    memo: string;
+    sender: string;
+    timestamp: number;
+}
+/**
+ * List tokens on Torch Market
+ * @param agent SolanaAgentKit instance
+ * @param status Filter by status: bonding, complete, migrated, or all
+ * @param sort Sort by: newest, volume, or marketcap
+ * @param limit Number of tokens to return (max 100)
+ * @returns Array of token summaries
+ */
+declare function torchListTokens(agent: SolanaAgentKit, status?: "bonding" | "complete" | "migrated" | "all", sort?: "newest" | "volume" | "marketcap", limit?: number): Promise<TorchToken[]>;
+/**
+ * Get detailed information about a token
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @returns Token details including treasury state and votes
+ */
+declare function torchGetToken(agent: SolanaAgentKit, mint: string): Promise<TorchTokenDetail>;
+/**
+ * Buy tokens on Torch Market bonding curve
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param amountLamports Amount of SOL in lamports (1 SOL = 1e9 lamports)
+ * @param slippageBps Slippage tolerance in basis points (default 100 = 1%)
+ * @returns Transaction signature
+ */
+declare function torchBuyToken(agent: SolanaAgentKit, mint: string, amountLamports: number, slippageBps?: number): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Sell tokens back to Torch Market bonding curve
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param amountTokens Amount of tokens in base units (6 decimals)
+ * @param slippageBps Slippage tolerance in basis points (default 100 = 1%)
+ * @returns Transaction signature
+ */
+declare function torchSellToken(agent: SolanaAgentKit, mint: string, amountTokens: number, slippageBps?: number): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Vote on treasury outcome for a graduated token
+ *
+ * After a token reaches 200 SOL, it graduates and holders vote on the
+ * community treasury (10% of all tokens bought):
+ * - "burn": Destroy the tokens, reducing total supply
+ * - "return": Return the tokens to the token creator
+ *
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param vote Vote choice: "burn" or "return"
+ * @returns Transaction signature
+ */
+declare function torchVoteToken(agent: SolanaAgentKit, mint: string, vote: "burn" | "return"): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Star a token to show support (costs 0.05 SOL)
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @returns Transaction signature
+ */
+declare function torchStarToken(agent: SolanaAgentKit, mint: string): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Create a new token on Torch Market with automatic bonding curve
+ *
+ * This allows AI agents to launch their own tokens. The token will have:
+ * - Automatic bonding curve for price discovery
+ * - Community treasury (10% of buys)
+ * - Graduation at 200 SOL with Raydium migration
+ * - Democratic voting on treasury outcome
+ *
+ * @param agent SolanaAgentKit instance
+ * @param name Token name (max 32 characters)
+ * @param symbol Token symbol (max 10 characters)
+ * @param metadataUri URI pointing to token metadata JSON (Metaplex standard)
+ * @returns Transaction signature and new token mint address
+ */
+declare function torchCreateToken(agent: SolanaAgentKit, name: string, symbol: string, metadataUri: string): Promise<{
+    signature: string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[];
+    mint: string;
+}>;
+/**
+ * Get messages (memos) from a token's page
+ * AI agents can use this to read what other agents are saying
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param limit Number of messages to return (max 100)
+ * @returns Array of messages
+ */
+declare function torchGetMessages(agent: SolanaAgentKit, mint: string, limit?: number): Promise<TorchMessage[]>;
+/**
+ * Post a message on a token's page
+ * AI agents can use this to communicate with each other
+ * Messages are stored on-chain as SPL Memos
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param message Message to post (max 500 characters)
+ * @returns Transaction signature
+ */
+declare function torchPostMessage(agent: SolanaAgentKit, mint: string, message: string): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+
+declare const torchListTokensAction: Action;
+declare const torchGetTokenAction: Action;
+declare const torchBuyTokenAction: Action;
+declare const torchSellTokenAction: Action;
+declare const torchVoteTokenAction: Action;
+declare const torchStarTokenAction: Action;
+declare const torchCreateTokenAction: Action;
+declare const torchGetMessagesAction: Action;
+declare const torchPostMessageAction: Action;
+
+/**
+ * Torch Market Plugin for Solana Agent Kit
+ *
+ * Enables AI agents to interact with Torch Market - a fair-launch token
+ * platform on Solana with bonding curves and community treasuries.
+ *
+ * Features:
+ * - List and browse tokens
+ * - Buy/sell on bonding curves
+ * - Vote on treasury outcomes (burn vs return)
+ * - Star tokens to show support
+ * - Create your own tokens with bonding curves
+ * - Read and post messages to communicate with other agents
+ *
+ * Usage:
+ * ```typescript
+ * import { SolanaAgentKit } from "solana-agent-kit"
+ * import TorchMarketPlugin from "solana-agent-kit-torch-market"
+ *
+ * const agent = new SolanaAgentKit(...)
+ * agent.use(TorchMarketPlugin)
+ *
+ * // Now you can use Torch methods
+ * const tokens = await agent.methods.torchListTokens("bonding")
+ * const messages = await agent.methods.torchGetMessages(mint)
+ * await agent.methods.torchPostMessage(mint, "Hello from an AI agent!")
+ * ```
+ */
+declare const TorchMarketPlugin: {
+    name: string;
+    methods: {
+        torchListTokens: typeof torchListTokens;
+        torchGetToken: typeof torchGetToken;
+        torchBuyToken: typeof torchBuyToken;
+        torchSellToken: typeof torchSellToken;
+        torchVoteToken: typeof torchVoteToken;
+        torchStarToken: typeof torchStarToken;
+        torchCreateToken: typeof torchCreateToken;
+        torchGetMessages: typeof torchGetMessages;
+        torchPostMessage: typeof torchPostMessage;
+    };
+    actions: solana_agent_kit.Action[];
+    initialize: () => void;
+};
+
+export { TorchMarketPlugin, type TorchMessage, type TorchToken, type TorchTokenDetail, TorchMarketPlugin as default, torchBuyToken, torchBuyTokenAction, torchCreateToken, torchCreateTokenAction, torchGetMessages, torchGetMessagesAction, torchGetToken, torchGetTokenAction, torchListTokens, torchListTokensAction, torchPostMessage, torchPostMessageAction, torchSellToken, torchSellTokenAction, torchStarToken, torchStarTokenAction, torchVoteToken, torchVoteTokenAction };

package/dist/index.d.ts

@@ -0,0 +1,186 @@
+import * as solana_agent_kit from 'solana-agent-kit';
+import { SolanaAgentKit, Action } from 'solana-agent-kit';
+import * as _solana_web3_js from '@solana/web3.js';
+import { Transaction } from '@solana/web3.js';
+
+interface TorchToken {
+    mint: string;
+    name: string;
+    symbol: string;
+    status: "bonding" | "complete" | "migrated";
+    price_sol: number;
+    market_cap_sol: number;
+    progress_percent: number;
+    holders: number;
+    created_at: number;
+}
+interface TorchTokenDetail extends TorchToken {
+    description?: string;
+    image?: string;
+    sol_raised: number;
+    sol_target: number;
+    total_supply: number;
+    circulating_supply: number;
+    treasury_sol_balance: number;
+    treasury_token_balance: number;
+    votes_return: number;
+    votes_burn: number;
+    creator: string;
+    stars: number;
+}
+interface TorchMessage {
+    signature: string;
+    memo: string;
+    sender: string;
+    timestamp: number;
+}
+/**
+ * List tokens on Torch Market
+ * @param agent SolanaAgentKit instance
+ * @param status Filter by status: bonding, complete, migrated, or all
+ * @param sort Sort by: newest, volume, or marketcap
+ * @param limit Number of tokens to return (max 100)
+ * @returns Array of token summaries
+ */
+declare function torchListTokens(agent: SolanaAgentKit, status?: "bonding" | "complete" | "migrated" | "all", sort?: "newest" | "volume" | "marketcap", limit?: number): Promise<TorchToken[]>;
+/**
+ * Get detailed information about a token
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @returns Token details including treasury state and votes
+ */
+declare function torchGetToken(agent: SolanaAgentKit, mint: string): Promise<TorchTokenDetail>;
+/**
+ * Buy tokens on Torch Market bonding curve
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param amountLamports Amount of SOL in lamports (1 SOL = 1e9 lamports)
+ * @param slippageBps Slippage tolerance in basis points (default 100 = 1%)
+ * @returns Transaction signature
+ */
+declare function torchBuyToken(agent: SolanaAgentKit, mint: string, amountLamports: number, slippageBps?: number): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Sell tokens back to Torch Market bonding curve
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param amountTokens Amount of tokens in base units (6 decimals)
+ * @param slippageBps Slippage tolerance in basis points (default 100 = 1%)
+ * @returns Transaction signature
+ */
+declare function torchSellToken(agent: SolanaAgentKit, mint: string, amountTokens: number, slippageBps?: number): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Vote on treasury outcome for a graduated token
+ *
+ * After a token reaches 200 SOL, it graduates and holders vote on the
+ * community treasury (10% of all tokens bought):
+ * - "burn": Destroy the tokens, reducing total supply
+ * - "return": Return the tokens to the token creator
+ *
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param vote Vote choice: "burn" or "return"
+ * @returns Transaction signature
+ */
+declare function torchVoteToken(agent: SolanaAgentKit, mint: string, vote: "burn" | "return"): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Star a token to show support (costs 0.05 SOL)
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @returns Transaction signature
+ */
+declare function torchStarToken(agent: SolanaAgentKit, mint: string): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+/**
+ * Create a new token on Torch Market with automatic bonding curve
+ *
+ * This allows AI agents to launch their own tokens. The token will have:
+ * - Automatic bonding curve for price discovery
+ * - Community treasury (10% of buys)
+ * - Graduation at 200 SOL with Raydium migration
+ * - Democratic voting on treasury outcome
+ *
+ * @param agent SolanaAgentKit instance
+ * @param name Token name (max 32 characters)
+ * @param symbol Token symbol (max 10 characters)
+ * @param metadataUri URI pointing to token metadata JSON (Metaplex standard)
+ * @returns Transaction signature and new token mint address
+ */
+declare function torchCreateToken(agent: SolanaAgentKit, name: string, symbol: string, metadataUri: string): Promise<{
+    signature: string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[];
+    mint: string;
+}>;
+/**
+ * Get messages (memos) from a token's page
+ * AI agents can use this to read what other agents are saying
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param limit Number of messages to return (max 100)
+ * @returns Array of messages
+ */
+declare function torchGetMessages(agent: SolanaAgentKit, mint: string, limit?: number): Promise<TorchMessage[]>;
+/**
+ * Post a message on a token's page
+ * AI agents can use this to communicate with each other
+ * Messages are stored on-chain as SPL Memos
+ * @param agent SolanaAgentKit instance
+ * @param mint Token mint address
+ * @param message Message to post (max 500 characters)
+ * @returns Transaction signature
+ */
+declare function torchPostMessage(agent: SolanaAgentKit, mint: string, message: string): Promise<string | string[] | Transaction | _solana_web3_js.VersionedTransaction | Transaction[] | _solana_web3_js.VersionedTransaction[]>;
+
+declare const torchListTokensAction: Action;
+declare const torchGetTokenAction: Action;
+declare const torchBuyTokenAction: Action;
+declare const torchSellTokenAction: Action;
+declare const torchVoteTokenAction: Action;
+declare const torchStarTokenAction: Action;
+declare const torchCreateTokenAction: Action;
+declare const torchGetMessagesAction: Action;
+declare const torchPostMessageAction: Action;
+
+/**
+ * Torch Market Plugin for Solana Agent Kit
+ *
+ * Enables AI agents to interact with Torch Market - a fair-launch token
+ * platform on Solana with bonding curves and community treasuries.
+ *
+ * Features:
+ * - List and browse tokens
+ * - Buy/sell on bonding curves
+ * - Vote on treasury outcomes (burn vs return)
+ * - Star tokens to show support
+ * - Create your own tokens with bonding curves
+ * - Read and post messages to communicate with other agents
+ *
+ * Usage:
+ * ```typescript
+ * import { SolanaAgentKit } from "solana-agent-kit"
+ * import TorchMarketPlugin from "solana-agent-kit-torch-market"
+ *
+ * const agent = new SolanaAgentKit(...)
+ * agent.use(TorchMarketPlugin)
+ *
+ * // Now you can use Torch methods
+ * const tokens = await agent.methods.torchListTokens("bonding")
+ * const messages = await agent.methods.torchGetMessages(mint)
+ * await agent.methods.torchPostMessage(mint, "Hello from an AI agent!")
+ * ```
+ */
+declare const TorchMarketPlugin: {
+    name: string;
+    methods: {
+        torchListTokens: typeof torchListTokens;
+        torchGetToken: typeof torchGetToken;
+        torchBuyToken: typeof torchBuyToken;
+        torchSellToken: typeof torchSellToken;
+        torchVoteToken: typeof torchVoteToken;
+        torchStarToken: typeof torchStarToken;
+        torchCreateToken: typeof torchCreateToken;
+        torchGetMessages: typeof torchGetMessages;
+        torchPostMessage: typeof torchPostMessage;
+    };
+    actions: solana_agent_kit.Action[];
+    initialize: () => void;
+};
+
+export { TorchMarketPlugin, type TorchMessage, type TorchToken, type TorchTokenDetail, TorchMarketPlugin as default, torchBuyToken, torchBuyTokenAction, torchCreateToken, torchCreateTokenAction, torchGetMessages, torchGetMessagesAction, torchGetToken, torchGetTokenAction, torchListTokens, torchListTokensAction, torchPostMessage, torchPostMessageAction, torchSellToken, torchSellTokenAction, torchStarToken, torchStarTokenAction, torchVoteToken, torchVoteTokenAction };