add sns support

Author: truemagic-coder

README.md

@@ -16,6 +16,7 @@ Solana Agent Kit provides a growing library of plugins that enhance your Solana
 * Solana Swap - Swap Solana tokens on Jupiter in the agent's wallet
 * Solana Balance - Get the token balances of a wallet
 * Solana Price - Get the price of a token
+* Solana SNS Lookup - Get the Solana address for a SNS domain
 * Rugcheck - Check if a token is a rug
 * Internet Search - Search the internet in real-time using Perplexity, Grok, or OpenAI
 * MCP - Interface with any MCP web server - Zapier is supported
@@ -93,6 +94,21 @@ config = {
 }
 ```
 
+### Solana SNS Lookup
+
+This plugin enables Solana Agent to get the Solana address of an SNS domain.
+
+```python
+config = {
+    "tools": {
+        "sns_lookup": {
+            "quicknode_url": "my-quicknode-rpc-url", # Required - your QuickNode RPC URL with the SNS addon enabled
+        },
+    },
+}
+```
+
+
 ### Rugcheck
 
 This plugin enables Solana Agent to check if a token is a rug. 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "sakit"
-version = "12.2.0"
+version = "12.3.0"
 description = "Solana Agent Kit"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -20,7 +20,7 @@ solana-agent = ">=30.0.0"
 boto3 = "^1.38.32"
 botocore = "^1.38.32"
 nemo-agent = "5.0.3"
-fastmcp = "^2.7.0"
+fastmcp = "^2.7.1"
 solana = "^0.36.7"
 solders = "^0.26.0"
 pynacl = "^1.5.0"
@@ -45,3 +45,4 @@ privy_swap = "sakit.privy_swap:get_plugin"
 privy_transfer = "sakit.privy_transfer:get_plugin"
 privy_balance = "sakit.privy_balance:get_plugin"
 privy_wallet_address = "sakit.privy_wallet_address:get_plugin"
+sns_lookup = "sakit.sns_lookup:get_plugin"

sakit/sns_lookup.py

@@ -0,0 +1,72 @@
+from typing import Dict, Any, List, Optional
+from solana_agent import AutoTool, ToolRegistry
+import httpx
+
+class SnsLookupTool(AutoTool):
+    def __init__(self, registry: Optional[ToolRegistry] = None):
+        super().__init__(
+            name="sns_lookup",
+            description="Lookup SNS domain with a QuickNode RPC.",
+            registry=registry,
+        )
+        self.quicknode_url = None
+
+    def get_schema(self) -> Dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "domain": {
+                    "type": "string",
+                    "description": "SNS domain to resolve, e.g. domain.sol",
+                }
+            },
+            "required": ["domain"],
+            "additionalProperties": False,
+        }
+
+    def configure(self, config: Dict[str, Any]) -> None:
+        super().configure(config)
+        tool_cfg = config.get("tools", {}).get("sns_lookup", {})
+        self.quicknode_url = tool_cfg.get("quicknode_url")
+
+    async def execute(self, domain: str) -> Dict[str, Any]:
+        if not self.quicknode_url:
+            return {"status": "error", "message": "No quicknode_url configured for SNS lookup."}
+        payload = {
+            "method": "sns_resolveDomain",
+            "params": [domain],
+            "id": 1,
+            "jsonrpc": "2.0",
+        }
+        headers = {"Content-Type": "application/json"}
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(self.quicknode_url, json=payload, headers=headers)
+            resp.raise_for_status()
+            data = resp.json()
+            return {"status": "success", "result": data}
+
+class SnsLookupPlugin:
+    def __init__(self):
+        self.name = "sns_lookup"
+        self.config = None
+        self.tool_registry = None
+        self._tool = None
+
+    @property
+    def description(self):
+        return "Plugin for resolving SNS domains using a QuickNode endpoint."
+
+    def initialize(self, tool_registry: ToolRegistry) -> None:
+        self.tool_registry = tool_registry
+        self._tool = SnsLookupTool(registry=tool_registry)
+
+    def configure(self, config: Dict[str, Any]) -> None:
+        self.config = config
+        if self._tool:
+            self._tool.configure(self.config)
+
+    def get_tools(self) -> List[AutoTool]:
+        return [self._tool] if self._tool else []
+
+def get_plugin():
+    return SnsLookupPlugin()