agentlaunch-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to `@agent-launch/sdk` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-22
+
+### Added
+
+- **`AgentLaunchClient`** — Core HTTP client with typed `get()` and `post()` methods
+  - Automatic `X-API-Key` header injection from `apiKey` config or `AGENTVERSE_API_KEY` env var
+  - Exponential backoff retry on HTTP 429 (rate limit) with configurable `maxRetries` (default: 3)
+  - Query-string builder that omits `undefined` values
+  - Typed `AgentLaunchError` with `status` and `serverMessage` properties
+
+- **Token operations** (`tokens.ts`)
+  - `tokenize(params)` — Create a pending token record, receive `token_id` and `handoff_link`
+  - `getToken(address)` — Fetch a deployed token by contract address
+  - `listTokens(params?)` — List tokens with pagination, filtering, and sorting
+
+- **Market operations** (`market.ts`)
+  - `getTokenPrice(address)` — Get current bonding-curve price in FET
+  - `getTokenHolders(address, holderAddress?)` — List holders or look up a specific wallet
+  - `generateTradeLink(address, action, amount?)` — Generate pre-filled trade URL (positional args)
+  - `generateTradeLinkFromOptions(address, opts?)` — Generate trade URL from options object
+
+- **Handoff link generation** (`handoff.ts`)
+  - `generateDeployLink(tokenId, baseUrl?)` — Deploy page URL for pending tokens
+  - `generateTradeLink(address, opts?, baseUrl?)` — Trade page URL for deployed tokens
+  - `generateBuyLink(address, amount?, baseUrl?)` — Buy link convenience wrapper
+  - `generateSellLink(address, amount?, baseUrl?)` — Sell link convenience wrapper
+
+- **Agent operations** (`agents.ts`)
+  - `authenticate(apiKey)` — Exchange Agentverse API key for platform JWT
+  - `getMyAgents()` — List Agentverse agents owned by the caller
+  - `importFromAgentverse(apiKey)` — Import agents by Agentverse API key
+
+- **`AgentLaunch` class** (`agentlaunch.ts`) — Fluent namespaced API
+  - `al.tokens.tokenize()`, `al.tokens.getToken()`, `al.tokens.listTokens()`
+  - `al.market.getTokenPrice()`, `al.market.getTokenHolders()`
+  - `al.handoff.generateDeployLink()`, `al.handoff.generateBuyLink()`, `al.handoff.generateSellLink()`
+  - `al.agents.authenticate()`, `al.agents.getMyAgents()`, `al.agents.importFromAgentverse()`
+
+- **TypeScript types** (`types.ts`)
+  - `AgentLaunchConfig`, `AgentLaunchError`
+  - `TokenizeParams`, `TokenizeResponse`, `Token`, `TokenListParams`, `TokenListResponse`
+  - `Holder`, `HolderListResponse`, `SingleHolderResponse`
+  - `TradeAction`, `TradeLinkOptions`
+  - `AgentAuthResponse`, `AgentverseAgent`, `MyAgentsResponse`, `ImportAgentverseResponse`
+
+- **Dual ESM + CJS exports** — Ships as ESM primary with CJS wrapper for CommonJS consumers
+- **Zero runtime dependencies** — Uses Node.js 18+ built-in `fetch()`
+- **Full test suite** — 4 test files covering client, handoff, market, and token operations
+
+### Platform Constants (immutable, set by deployed smart contracts)
+
+| Constant | Value |
+|----------|-------|
+| `TARGET_LIQUIDITY` | 30,000 FET |
+| `TOTAL_BUY_TOKENS` | 800,000,000 |
+| `FEE_PERCENTAGE` | 2% — 100% to protocol treasury |
+| `TOKEN_DEPLOYMENT_FEE` | 120 FET (read dynamically) |
+
+[0.1.0]: https://github.com/agent-launch/sdk/releases/tag/v0.1.0

package/README.md

@@ -0,0 +1,319 @@
+# @agent-launch/sdk
+
+[![npm version](https://img.shields.io/npm/v/@agent-launch/sdk.svg)](https://www.npmjs.com/package/@agent-launch/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@agent-launch/sdk.svg)](https://nodejs.org)
+
+TypeScript SDK for the [AgentLaunch](https://agent-launch.ai) platform — create AI agent tokens, query market data, and generate human handoff links.
+
+No external runtime dependencies. Uses the global `fetch()` available in Node.js 18+.
+
+## Install
+
+```bash
+npm install @agent-launch/sdk
+```
+
+## Quick Start
+
+```typescript
+import { tokenize, generateDeployLink } from '@agent-launch/sdk';
+
+// 1. Create a pending token record
+const { data } = await tokenize({
+  agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',
+  name: 'My Agent Token',
+  chainId: 97, // BSC Testnet
+});
+
+// 2. Generate a deploy link for a human to complete on-chain deployment
+const link = generateDeployLink(data.token_id);
+console.log(link); // https://agent-launch.ai/deploy/42
+```
+
+## Authentication
+
+All write operations require an Agentverse API key.
+
+**Option 1 — Environment variable (recommended):**
+
+```bash
+export AGENTVERSE_API_KEY=av-xxxxxxxxxxxxxxxx
+```
+
+**Option 2 — Pass directly to the client:**
+
+```typescript
+import { AgentLaunchClient } from '@agent-launch/sdk';
+
+const client = new AgentLaunchClient({ apiKey: 'av-xxxxxxxxxxxxxxxx' });
+```
+
+## API Reference
+
+### Token Operations
+
+#### `tokenize(params, client?)`
+
+Create a pending token record for an Agentverse agent.
+
+```typescript
+import { tokenize } from '@agent-launch/sdk';
+
+const { data } = await tokenize({
+  agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',  // required
+  name: 'My Agent Token',                            // optional — fetched from Agentverse
+  symbol: 'MAT',                                     // optional — derived from name
+  description: 'An AI agent that...',               // optional
+  image: 'https://example.com/logo.png',             // optional — 'auto' for placeholder
+  chainId: 97,                                       // optional — default: 11155111 (Sepolia)
+});
+
+console.log(data.token_id);      // 42
+console.log(data.handoff_link);  // https://agent-launch.ai/deploy/42
+console.log(data.status);        // 'pending_deployment'
+```
+
+**Supported chain IDs:**
+| Chain | ID |
+|-------|----|
+| BSC Mainnet | 56 |
+| BSC Testnet | 97 |
+| Ethereum Mainnet | 1 |
+| Ethereum Sepolia | 11155111 |
+
+#### `getToken(address, client?)`
+
+Fetch a single token by its deployed contract address.
+
+```typescript
+import { getToken } from '@agent-launch/sdk';
+
+const token = await getToken('0xAbCd...');
+console.log(token.price);       // '0.000012' (FET)
+console.log(token.market_cap);  // '9600' (FET)
+console.log(token.progress);    // 32 (% toward 30,000 FET graduation)
+console.log(token.listed);      // false
+```
+
+#### `listTokens(params?, client?)`
+
+List tokens with optional filtering and pagination.
+
+```typescript
+import { listTokens } from '@agent-launch/sdk';
+
+const { tokens, total } = await listTokens({
+  page: 1,
+  limit: 20,
+  search: 'agent',
+  sortBy: 'market_cap',
+  sortOrder: 'DESC',
+  chainId: 97,
+});
+```
+
+### Market Operations
+
+#### `getTokenPrice(address, client?)`
+
+Get the current bonding-curve price of a token in FET.
+
+```typescript
+import { getTokenPrice } from '@agent-launch/sdk';
+
+const price = await getTokenPrice('0xAbCd...');
+console.log(`Current price: ${price} FET`);
+```
+
+#### `getTokenHolders(address, holderAddress?, client?)`
+
+Get the holder list for a token, or look up a specific wallet.
+
+```typescript
+import { getTokenHolders } from '@agent-launch/sdk';
+
+// Full holder list
+const { holders, total } = await getTokenHolders('0xAbCd...');
+
+// Single holder lookup
+const holder = await getTokenHolders('0xAbCd...', '0xUserWallet...');
+```
+
+### Handoff Link Generation
+
+Agents never hold private keys or sign transactions. All on-chain actions are delegated to humans via handoff links.
+
+#### `generateDeployLink(tokenId, baseUrl?)`
+
+Generate a deploy handoff link for a pending token.
+
+```typescript
+import { generateDeployLink } from '@agent-launch/sdk';
+
+const link = generateDeployLink(42);
+// https://agent-launch.ai/deploy/42
+
+// Custom platform URL (for testing)
+const devLink = generateDeployLink(42, 'https://staging.agent-launch.ai');
+// https://staging.agent-launch.ai/deploy/42
+```
+
+#### `generateTradeLink(address, opts?, baseUrl?)`
+
+Generate a pre-filled trade URL for a human.
+
+```typescript
+import { generateTradeLink } from '@agent-launch/sdk';
+
+// Basic trade page
+generateTradeLink('0xAbCd...');
+// https://agent-launch.ai/trade/0xAbCd...
+
+// Pre-filled buy
+generateTradeLink('0xAbCd...', { action: 'buy', amount: 100 });
+// https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+
+// Pre-filled sell
+generateTradeLink('0xAbCd...', { action: 'sell', amount: 500 });
+// https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+```
+
+#### `generateBuyLink(address, amount?, baseUrl?)`
+
+Convenience wrapper for buy links.
+
+```typescript
+import { generateBuyLink } from '@agent-launch/sdk';
+
+const link = generateBuyLink('0xAbCd...', 100);
+// https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+```
+
+#### `generateSellLink(address, amount?, baseUrl?)`
+
+Convenience wrapper for sell links.
+
+```typescript
+import { generateSellLink } from '@agent-launch/sdk';
+
+const link = generateSellLink('0xAbCd...', 500);
+// https://agent-launch.ai/trade/0xAbCd...?action=sell&amount=500
+```
+
+### Agent Operations
+
+#### `authenticate(apiKey, client?)`
+
+Exchange an Agentverse API key for a platform JWT.
+
+```typescript
+import { authenticate } from '@agent-launch/sdk';
+
+const { data } = await authenticate('av-xxxxxxxxxxxxxxxx');
+console.log(data.token);      // JWT string
+console.log(data.expires_in); // seconds until expiry
+```
+
+#### `getMyAgents(client?)`
+
+List the Agentverse agents owned by the caller's API key.
+
+```typescript
+import { getMyAgents } from '@agent-launch/sdk';
+
+const { data } = await getMyAgents();
+console.log(data.agents.map(a => a.address));
+```
+
+#### `importFromAgentverse(agentverseApiKey, client?)`
+
+Fetch all agents belonging to an Agentverse API key.
+
+```typescript
+import { importFromAgentverse } from '@agent-launch/sdk';
+
+const { agents, count } = await importFromAgentverse('av-xxxxxxxxxxxxxxxx');
+```
+
+### Fluent API — `AgentLaunch` class
+
+For a more ergonomic interface, use the `AgentLaunch` class:
+
+```typescript
+import { AgentLaunch } from '@agent-launch/sdk';
+
+const al = new AgentLaunch({ apiKey: 'av-xxxxxxxxxxxxxxxx' });
+
+// Token operations
+const { data } = await al.tokens.tokenize({ agentAddress: 'agent1q...' });
+const token = await al.tokens.getToken('0xAbCd...');
+const { tokens } = await al.tokens.listTokens({ sortBy: 'market_cap' });
+
+// Market operations
+const price = await al.market.getTokenPrice('0xAbCd...');
+const { holders } = await al.market.getTokenHolders('0xAbCd...');
+
+// Handoff links (synchronous)
+const deployLink = al.handoff.generateDeployLink(data.token_id);
+const buyLink = al.handoff.generateBuyLink('0xAbCd...', 100);
+const sellLink = al.handoff.generateSellLink('0xAbCd...', 500);
+
+// Agent operations
+const { data: authData } = await al.agents.authenticate('av-xxxxxxxxxxxxxxxx');
+const { data: agentsData } = await al.agents.getMyAgents();
+```
+
+### `AgentLaunchClient`
+
+The underlying HTTP client. Use directly for advanced scenarios.
+
+```typescript
+import { AgentLaunchClient } from '@agent-launch/sdk';
+
+const client = new AgentLaunchClient({
+  apiKey: process.env.AGENTVERSE_API_KEY,
+  baseUrl: 'https://agent-launch.ai', // default
+  maxRetries: 3,                       // default — retries on 429 rate limit
+});
+
+// Typed GET
+const data = await client.get<MyType>('/api/agents/tokens', { page: 1 });
+
+// Typed POST (requires apiKey)
+const result = await client.post<MyType>('/api/agents/tokenize', body);
+```
+
+## Error Handling
+
+All SDK methods throw `AgentLaunchError` on non-2xx responses.
+
+```typescript
+import { tokenize, AgentLaunchError } from '@agent-launch/sdk';
+
+try {
+  const { data } = await tokenize({ agentAddress: 'agent1q...' });
+} catch (err) {
+  if (err instanceof AgentLaunchError) {
+    console.error(`HTTP ${err.status}: ${err.message}`);
+    console.error('Server message:', err.serverMessage);
+  }
+}
+```
+
+`AgentLaunchError` properties:
+- `status` — HTTP status code (0 for network-level failures or missing API key)
+- `message` — Human-readable error message
+- `serverMessage` — Original server error message when available
+
+## Platform Information
+
+- **Target Liquidity:** 30,000 FET — tokens auto-list on DEX when reached
+- **Total Buy Tokens:** 800,000,000
+- **Deployment Fee:** 120 FET (read dynamically from contract, can change via governance)
+- **Trading Fee:** 2% per transaction — goes 100% to the protocol treasury. There is no creator fee.
+- **Default Chain:** BSC (mainnet: 56, testnet: 97)
+
+## License
+
+MIT

package/dist/agentlaunch.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @agent-launch/sdk — AgentLaunch fluent wrapper class
+ *
+ * SDK-006: Provides a namespaced, ergonomic API wrapping all SDK modules.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunch } from '@agent-launch/sdk';
+ *
+ * const al = new AgentLaunch({ apiKey: process.env.AGENTVERSE_API_KEY });
+ *
+ * const { data } = await al.tokens.tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',
+ *   chainId: 97,
+ * });
+ *
+ * const link = al.handoff.generateDeployLink(data.token_id);
+ * ```
+ */
+import { AgentLaunchClient } from './client.js';
+import type { AgentLaunchConfig, TokenizeParams, TokenListParams, TokenizeResponse, Token, TokenListResponse, HolderListResponse, SingleHolderResponse, TradeLinkOptions, AgentAuthResponse, MyAgentsResponse, ImportAgentverseResponse } from './types.js';
+/** Token-related operations. */
+export interface TokensNamespace {
+    /**
+     * Create a pending token record.
+     * @see tokenize
+     */
+    tokenize(params: TokenizeParams): Promise<{
+        success: true;
+        data: TokenizeResponse;
+    }>;
+    /**
+     * Fetch a deployed token by contract address.
+     * @see getToken
+     */
+    getToken(address: string): Promise<Token>;
+    /**
+     * List tokens with optional filtering and pagination.
+     * @see listTokens
+     */
+    listTokens(params?: TokenListParams): Promise<TokenListResponse>;
+}
+/** Market data operations. */
+export interface MarketNamespace {
+    /**
+     * Get the current bonding-curve price in FET.
+     * @see getTokenPrice
+     */
+    getTokenPrice(address: string): Promise<string>;
+    /**
+     * Get the holder list, or look up a specific wallet.
+     * @see getTokenHolders
+     */
+    getTokenHolders(address: string, holderAddress?: string): Promise<HolderListResponse | SingleHolderResponse>;
+}
+/** Handoff link generation (synchronous). */
+export interface HandoffNamespace {
+    /**
+     * Generate a deploy handoff link for a pending token.
+     * @see generateDeployLink
+     */
+    generateDeployLink(tokenId: number, baseUrl?: string): string;
+    /**
+     * Generate a trade handoff link for a deployed token.
+     * @see generateTradeLink
+     */
+    generateTradeLink(address: string, opts?: TradeLinkOptions, baseUrl?: string): string;
+    /**
+     * Generate a buy link with optional pre-filled FET amount.
+     * @see generateBuyLink
+     */
+    generateBuyLink(address: string, amount?: number | string, baseUrl?: string): string;
+    /**
+     * Generate a sell link with optional pre-filled token amount.
+     * @see generateSellLink
+     */
+    generateSellLink(address: string, amount?: number | string, baseUrl?: string): string;
+}
+/** Agent authentication and management. */
+export interface AgentsNamespace {
+    /**
+     * Exchange an Agentverse API key for a platform JWT.
+     * @see authenticate
+     */
+    authenticate(apiKey: string): Promise<AgentAuthResponse>;
+    /**
+     * List the Agentverse agents owned by the caller's API key.
+     * @see getMyAgents
+     */
+    getMyAgents(): Promise<MyAgentsResponse>;
+    /**
+     * Import agents by Agentverse API key.
+     * @see importFromAgentverse
+     */
+    importFromAgentverse(agentverseApiKey: string): Promise<ImportAgentverseResponse>;
+}
+/**
+ * AgentLaunch
+ *
+ * Fluent, namespaced wrapper around the AgentLaunch SDK modules.  Instantiate
+ * once and use the `tokens`, `market`, `handoff`, and `agents` namespaces to
+ * access all platform operations.
+ *
+ * Authentication is shared across all namespaces via the underlying
+ * `AgentLaunchClient` instance.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunch } from '@agent-launch/sdk';
+ *
+ * const al = new AgentLaunch({ apiKey: 'av-xxxxxxxxxxxxxxxx' });
+ *
+ * // Create token
+ * const { data } = await al.tokens.tokenize({ agentAddress: 'agent1q...' });
+ *
+ * // Generate links
+ * const deployLink = al.handoff.generateDeployLink(data.token_id);
+ * const buyLink    = al.handoff.generateBuyLink('0xAbCd...', 100);
+ *
+ * // Query market
+ * const price   = await al.market.getTokenPrice('0xAbCd...');
+ * const { holders } = await al.market.getTokenHolders('0xAbCd...');
+ * ```
+ */
+export declare class AgentLaunch {
+    /** The underlying HTTP client shared by all namespaces. */
+    readonly client: AgentLaunchClient;
+    /** Token CRUD and listing operations. */
+    readonly tokens: TokensNamespace;
+    /** Price, holder, and trade-link operations. */
+    readonly market: MarketNamespace;
+    /** Handoff URL generation (synchronous, no network calls). */
+    readonly handoff: HandoffNamespace;
+    /** Agent authentication and Agentverse management. */
+    readonly agents: AgentsNamespace;
+    constructor(config?: AgentLaunchConfig);
+}
+//# sourceMappingURL=agentlaunch.d.ts.map

package/dist/agentlaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentlaunch.d.ts","sourceRoot":"","sources":["../src/agentlaunch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUhD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAMpB,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1C;;;OAGG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAClE;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,GAAG,oBAAoB,CAAC,CAAC;CACvD;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9D;;;OAGG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC;IAEV;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC;IAEV;;;OAGG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC;CACX;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEzD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEzC;;;OAGG;IACH,oBAAoB,CAClB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAEnC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBAErB,MAAM,GAAE,iBAAsB;CA+C3C"}

package/dist/agentlaunch.js

@@ -0,0 +1,85 @@
+/**
+ * @agent-launch/sdk — AgentLaunch fluent wrapper class
+ *
+ * SDK-006: Provides a namespaced, ergonomic API wrapping all SDK modules.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunch } from '@agent-launch/sdk';
+ *
+ * const al = new AgentLaunch({ apiKey: process.env.AGENTVERSE_API_KEY });
+ *
+ * const { data } = await al.tokens.tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',
+ *   chainId: 97,
+ * });
+ *
+ * const link = al.handoff.generateDeployLink(data.token_id);
+ * ```
+ */
+import { AgentLaunchClient } from './client.js';
+import { tokenize, getToken, listTokens } from './tokens.js';
+import { getTokenPrice, getTokenHolders } from './market.js';
+import { generateDeployLink, generateTradeLink, generateBuyLink, generateSellLink, } from './handoff.js';
+import { authenticate, getMyAgents, importFromAgentverse } from './agents.js';
+// ---------------------------------------------------------------------------
+// AgentLaunch class
+// ---------------------------------------------------------------------------
+/**
+ * AgentLaunch
+ *
+ * Fluent, namespaced wrapper around the AgentLaunch SDK modules.  Instantiate
+ * once and use the `tokens`, `market`, `handoff`, and `agents` namespaces to
+ * access all platform operations.
+ *
+ * Authentication is shared across all namespaces via the underlying
+ * `AgentLaunchClient` instance.
+ *
+ * @example
+ * ```ts
+ * import { AgentLaunch } from '@agent-launch/sdk';
+ *
+ * const al = new AgentLaunch({ apiKey: 'av-xxxxxxxxxxxxxxxx' });
+ *
+ * // Create token
+ * const { data } = await al.tokens.tokenize({ agentAddress: 'agent1q...' });
+ *
+ * // Generate links
+ * const deployLink = al.handoff.generateDeployLink(data.token_id);
+ * const buyLink    = al.handoff.generateBuyLink('0xAbCd...', 100);
+ *
+ * // Query market
+ * const price   = await al.market.getTokenPrice('0xAbCd...');
+ * const { holders } = await al.market.getTokenHolders('0xAbCd...');
+ * ```
+ */
+export class AgentLaunch {
+    constructor(config = {}) {
+        this.client = new AgentLaunchClient(config);
+        // Capture client reference for closures
+        const client = this.client;
+        this.tokens = {
+            tokenize: (params) => tokenize(params, client),
+            getToken: (address) => getToken(address, client),
+            listTokens: (params) => listTokens(params ?? {}, client),
+        };
+        this.market = {
+            getTokenPrice: (address) => getTokenPrice(address, client),
+            getTokenHolders: (address, holderAddress) => getTokenHolders(address, holderAddress, client),
+        };
+        // Handoff methods use the client's baseUrl for URL generation
+        const baseUrl = this.client.baseUrl;
+        this.handoff = {
+            generateDeployLink: (tokenId, overrideBaseUrl) => generateDeployLink(tokenId, overrideBaseUrl ?? baseUrl),
+            generateTradeLink: (address, opts, overrideBaseUrl) => generateTradeLink(address, opts, overrideBaseUrl ?? baseUrl),
+            generateBuyLink: (address, amount, overrideBaseUrl) => generateBuyLink(address, amount, overrideBaseUrl ?? baseUrl),
+            generateSellLink: (address, amount, overrideBaseUrl) => generateSellLink(address, amount, overrideBaseUrl ?? baseUrl),
+        };
+        this.agents = {
+            authenticate: (apiKey) => authenticate(apiKey, client),
+            getMyAgents: () => getMyAgents(client),
+            importFromAgentverse: (agentverseApiKey) => importFromAgentverse(agentverseApiKey, client),
+        };
+    }
+}
+//# sourceMappingURL=agentlaunch.js.map

package/dist/agentlaunch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentlaunch.js","sourceRoot":"","sources":["../src/agentlaunch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2H9E,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,WAAW;IAgBtB,YAAY,SAA4B,EAAE;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE5C,wCAAwC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,CAAC,MAAsB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAC9D,QAAQ,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACxD,UAAU,EAAE,CAAC,MAAwB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC;SAC3E,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG;YACZ,aAAa,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC;YAClE,eAAe,EAAE,CAAC,OAAe,EAAE,aAAsB,EAAE,EAAE,CAC3D,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC;SAClD,CAAC;QAEF,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG;YACb,kBAAkB,EAAE,CAAC,OAAe,EAAE,eAAwB,EAAE,EAAE,CAChE,kBAAkB,CAAC,OAAO,EAAE,eAAe,IAAI,OAAO,CAAC;YACzD,iBAAiB,EAAE,CACjB,OAAe,EACf,IAAuB,EACvB,eAAwB,EACxB,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,IAAI,OAAO,CAAC;YACjE,eAAe,EAAE,CACf,OAAe,EACf,MAAwB,EACxB,eAAwB,EACxB,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,IAAI,OAAO,CAAC;YACjE,gBAAgB,EAAE,CAChB,OAAe,EACf,MAAwB,EACxB,eAAwB,EACxB,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,IAAI,OAAO,CAAC;SACnE,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG;YACZ,YAAY,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC;YAC9D,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;YACtC,oBAAoB,EAAE,CAAC,gBAAwB,EAAE,EAAE,CACjD,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,CAAC;SACjD,CAAC;IACJ,CAAC;CACF"}

package/dist/agents.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @agent-launch/sdk — Agent operations
+ *
+ * SDK-005: Authentication and Agentverse agent management.
+ *
+ * These endpoints let an agent:
+ *   - Exchange an Agentverse API key for a platform JWT (POST /agents/auth)
+ *   - List its own Agentverse agents (GET /agents/my-agents)
+ *   - Import agent metadata by API key (POST /agents/import-agentverse)
+ */
+import { AgentLaunchClient } from './client.js';
+import type { AgentAuthResponse, MyAgentsResponse, ImportAgentverseResponse } from './types.js';
+/**
+ * Exchange an Agentverse API key for a platform JWT.
+ *
+ * The JWT can be used as a `Bearer` token on any endpoint that requires
+ * platform authentication (same access level as an X-API-Key header).
+ *
+ * Rate limit: 10 requests per 60 seconds.
+ *
+ * @param apiKey  Agentverse API key (av-…)
+ * @param client  Optional pre-configured client instance
+ *
+ * @example
+ * ```ts
+ * const { data } = await authenticate('av-xxxxxxxxxxxxxxxx');
+ * // data.token — JWT string
+ * // data.expires_in — seconds until expiry
+ * ```
+ */
+export declare function authenticate(apiKey: string, client?: AgentLaunchClient): Promise<AgentAuthResponse>;
+/**
+ * List the Agentverse agents owned by the caller's API key.
+ *
+ * Requires X-API-Key authentication.
+ *
+ * Rate limit: 30 requests per 60 seconds.
+ *
+ * @example
+ * ```ts
+ * const { data } = await getMyAgents();
+ * console.log(data.agents.map(a => a.address));
+ * ```
+ */
+export declare function getMyAgents(client?: AgentLaunchClient): Promise<MyAgentsResponse>;
+/**
+ * Fetch all agents belonging to the supplied Agentverse API key.
+ *
+ * No platform authentication is required — the caller provides their own
+ * Agentverse key in the request body.  Results are cached on the server
+ * for 5 minutes.
+ *
+ * Useful for building integrations that need to enumerate an account's
+ * agents without a pre-existing platform session.
+ *
+ * Rate limit: 5 requests per 60 seconds.
+ *
+ * @param agentverseApiKey  Agentverse API key to import agents from
+ * @param client            Optional pre-configured client instance
+ *
+ * @example
+ * ```ts
+ * const { agents, count } = await importFromAgentverse('av-xxxxxxxxxxxxxxxx');
+ * ```
+ */
+export declare function importFromAgentverse(agentverseApiKey: string, client?: AgentLaunchClient): Promise<ImportAgentverseResponse>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAiBpB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,gBAAgB,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAWnC"}