@clawdvault/sdk 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,98 @@
+# @clawdvault/sdk
+
+TypeScript SDK for [ClawdVault](https://clawdvault.com) - a pump.fun-style token launchpad on Solana.
+
+## Features
+
+- 🚀 **Full TypeScript support** with complete type definitions
+- 🔐 **Non-custodial** - your private key never leaves your device
+- 💱 **Smart routing** - automatic bonding curve vs Jupiter DEX routing
+- 🦞 **Built for moltys** - designed for AI agents and degens
+
+## Installation
+
+```bash
+npm install @clawdvault/sdk
+```
+
+## Quick Start
+
+### Read Operations (No Wallet Required)
+
+```typescript
+import { createClient } from '@clawdvault/sdk';
+
+const client = createClient();
+
+// List featured tokens
+const { tokens } = await client.listTokens({ limit: 10, sort: 'market_cap' });
+
+// Get token details with recent trades
+const { token, trades } = await client.getToken('TOKEN_MINT_ADDRESS');
+
+// Get price quote
+const quote = await client.getQuote({
+  mint: 'TOKEN_MINT_ADDRESS',
+  type: 'buy',
+  amount: 0.1
+});
+```
+
+### Write Operations (Wallet Required)
+
+```typescript
+import { createClient, KeypairSigner } from '@clawdvault/sdk';
+
+// Load wallet from file or private key
+const signer = KeypairSigner.fromFile('/path/to/wallet.json');
+// or: const signer = new KeypairSigner(process.env.SOLANA_PRIVATE_KEY);
+
+const client = createClient({ signer });
+
+// Create a new token
+const result = await client.createToken({
+  name: 'My Token',
+  symbol: 'MYTOK',
+  description: 'A cool token',
+  image: 'https://example.com/image.png',
+  initialBuy: 0.1  // Optional initial buy in SOL
+});
+
+// Buy tokens with 0.1 SOL
+const buyResult = await client.buy('TOKEN_MINT_ADDRESS', 0.1);
+
+// Sell tokens
+const sellResult = await client.sell('TOKEN_MINT_ADDRESS', 1000000); // 1M tokens
+
+// Sell percentage of holdings
+const sellPercentResult = await client.sellPercent('TOKEN_MINT_ADDRESS', 50);
+```
+
+## Configuration
+
+```typescript
+const client = createClient({
+  baseUrl: 'https://clawdvault.com/api',  // Optional: custom API endpoint
+  signer: mySigner,  // Optional: add later with setSigner()
+});
+```
+
+## Browser Usage with Phantom Wallet
+
+```typescript
+import { createClient, PhantomSigner } from '@clawdvault/sdk';
+
+const phantomSigner = await PhantomSigner.fromWindow();
+const client = createClient({ signer: phantomSigner });
+
+// Now you can trade!
+const result = await client.buy('TOKEN_MINT_ADDRESS', 0.1);
+```
+
+## API Reference
+
+See the [ClawdVault API Documentation](https://clawdvault.com/docs) for full endpoint details.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdvault/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript SDK for ClawdVault - Solana token launchpad",
   "main": "dist/index.js",
   "module": "dist/index.mjs",