agentlaunch-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * @agent-launch/sdk
+ *
+ * TypeScript SDK for the AgentLaunch platform (agent-launch.ai).
+ *
+ * Enables AI agents and developers to:
+ *   - Create token records and receive human handoff links
+ *   - Query token prices, market data, and holder information
+ *   - Generate pre-filled deploy and trade URLs for human users
+ *   - Authenticate with Agentverse API keys
+ *   - List and import Agentverse agents
+ *
+ * Quick start:
+ * ```ts
+ * import { tokenize, generateDeployLink } from '@agent-launch/sdk';
+ *
+ * const { data } = await tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj...',
+ *   name: 'My Agent Token',
+ *   chainId: 97,
+ * });
+ *
+ * const link = generateDeployLink(data.token_id);
+ * // Share this link with a human → they connect wallet → token is live
+ * ```
+ *
+ * Authentication:
+ *   Set AGENTVERSE_API_KEY in your environment, or pass `apiKey` directly
+ *   to AgentLaunchClient.
+ *
+ * Platform fee:
+ *   A 2% fee applies to every buy and sell transaction.
+ *   This fee goes 100% to the protocol treasury (REVENUE_ACCOUNT).
+ *   There is no creator fee.
+ */
+// Fluent wrapper class
+export { AgentLaunch } from './agentlaunch.js';
+// Core HTTP client
+export { AgentLaunchClient } from './client.js';
+export { AgentLaunchError } from './types.js';
+// SDK-002: Token operations
+export { tokenize, getToken, listTokens } from './tokens.js';
+// SDK-003: Market operations
+export { getTokenPrice, getTokenHolders, generateTradeLink as generateTradeLinkWithAction, generateTradeLinkFromOptions, } from './market.js';
+// SDK-004: Handoff link generation
+export { generateDeployLink, generateTradeLink, generateBuyLink, generateSellLink, } from './handoff.js';
+// SDK-005: Agent operations
+export { authenticate, getMyAgents, importFromAgentverse } from './agents.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,IAAI,2BAA2B,EAChD,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/market.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @agent-launch/sdk — Market operations
+ *
+ * SDK-003: Price queries, holder data, and trade-link generation.
+ *
+ * Platform constants (immutable, set by deployed smart contracts):
+ *   - TARGET_LIQUIDITY = 30,000 FET  → auto DEX listing
+ *   - TOTAL_BUY_TOKENS = 800,000,000
+ *   - FEE_PERCENTAGE   = 2%          → 100% to protocol treasury (REVENUE_ACCOUNT)
+ *                                       No creator fee.
+ */
+import { AgentLaunchClient } from './client.js';
+import type { HolderListResponse, SingleHolderResponse, TradeAction, TradeLinkOptions } from './types.js';
+/**
+ * Get the current bonding-curve price of a token in FET.
+ *
+ * Fetches the full token details and returns the `price` field.  For bulk
+ * price fetching use `listTokens()` which returns prices for all tokens
+ * in a single request.
+ *
+ * No authentication required.
+ *
+ * @returns Current price as a string (preserves decimal precision)
+ *
+ * @example
+ * ```ts
+ * const price = await getTokenPrice('0xAbCd...');
+ * console.log(`Current price: ${price} FET`);
+ * ```
+ */
+export declare function getTokenPrice(address: string, client?: AgentLaunchClient): Promise<string>;
+/**
+ * Get the list of token holders for a deployed token.
+ *
+ * Useful for implementing token-gated access: check whether a given wallet
+ * holds any of a particular agent's token.
+ *
+ * Pass `holderAddress` to look up a specific wallet instead of the full list.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * // Full holder list
+ * const { holders, total } = await getTokenHolders('0xAbCd...');
+ *
+ * // Single holder lookup (returns null if not a holder)
+ * const holder = await getTokenHolders('0xAbCd...', '0xUser...');
+ * ```
+ */
+export declare function getTokenHolders(address: string, holderAddress?: string, client?: AgentLaunchClient): Promise<HolderListResponse | SingleHolderResponse>;
+/**
+ * Generate a pre-filled trade URL for a human to open.
+ *
+ * The returned URL opens the trade page with the action and amount
+ * pre-filled so the user only needs to connect their wallet and confirm.
+ *
+ * Agents should share this link rather than attempting to sign transactions
+ * on behalf of users.
+ *
+ * @param address Token contract address
+ * @param action  'buy' or 'sell'
+ * @param amount  Optional pre-fill amount (FET for buys, token units for sells)
+ *
+ * @example
+ * ```ts
+ * const link = generateTradeLink('0xAbCd...', 'buy', 100);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ * ```
+ */
+export declare function generateTradeLink(address: string, action: TradeAction, amount?: number | string, client?: AgentLaunchClient): string;
+/**
+ * Overload that accepts a TradeLinkOptions object instead of positional args.
+ *
+ * @example
+ * ```ts
+ * const link = generateTradeLinkFromOptions('0xAbCd...', { action: 'sell', amount: 500 });
+ * ```
+ */
+export declare function generateTradeLinkFromOptions(address: string, options?: TradeLinkOptions, client?: AgentLaunchClient): string;
+//# sourceMappingURL=market.d.ts.map

package/dist/market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,GAAG,oBAAoB,CAAC,CAqBpD;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,iBAAiB,GACzB,MAAM,CAWR;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,EAC9B,MAAM,CAAC,EAAE,iBAAiB,GACzB,MAAM,CAOR"}

package/dist/market.js

@@ -0,0 +1,125 @@
+/**
+ * @agent-launch/sdk — Market operations
+ *
+ * SDK-003: Price queries, holder data, and trade-link generation.
+ *
+ * Platform constants (immutable, set by deployed smart contracts):
+ *   - TARGET_LIQUIDITY = 30,000 FET  → auto DEX listing
+ *   - TOTAL_BUY_TOKENS = 800,000,000
+ *   - FEE_PERCENTAGE   = 2%          → 100% to protocol treasury (REVENUE_ACCOUNT)
+ *                                       No creator fee.
+ */
+import { AgentLaunchClient } from './client.js';
+import { getToken } from './tokens.js';
+// ---------------------------------------------------------------------------
+// Module-level default client (lazy, env-based)
+// ---------------------------------------------------------------------------
+function defaultClient() {
+    return new AgentLaunchClient({
+        apiKey: process.env['AGENTVERSE_API_KEY'] ?? process.env['AGENT_LAUNCH_API_KEY'],
+        baseUrl: process.env['AGENT_LAUNCH_BASE_URL'],
+    });
+}
+// ---------------------------------------------------------------------------
+// getTokenPrice
+// ---------------------------------------------------------------------------
+/**
+ * Get the current bonding-curve price of a token in FET.
+ *
+ * Fetches the full token details and returns the `price` field.  For bulk
+ * price fetching use `listTokens()` which returns prices for all tokens
+ * in a single request.
+ *
+ * No authentication required.
+ *
+ * @returns Current price as a string (preserves decimal precision)
+ *
+ * @example
+ * ```ts
+ * const price = await getTokenPrice('0xAbCd...');
+ * console.log(`Current price: ${price} FET`);
+ * ```
+ */
+export async function getTokenPrice(address, client) {
+    const token = await getToken(address, client);
+    return token.price;
+}
+// ---------------------------------------------------------------------------
+// getTokenHolders
+// ---------------------------------------------------------------------------
+/**
+ * Get the list of token holders for a deployed token.
+ *
+ * Useful for implementing token-gated access: check whether a given wallet
+ * holds any of a particular agent's token.
+ *
+ * Pass `holderAddress` to look up a specific wallet instead of the full list.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * // Full holder list
+ * const { holders, total } = await getTokenHolders('0xAbCd...');
+ *
+ * // Single holder lookup (returns null if not a holder)
+ * const holder = await getTokenHolders('0xAbCd...', '0xUser...');
+ * ```
+ */
+export async function getTokenHolders(address, holderAddress, client) {
+    const c = client ?? defaultClient();
+    const params = {};
+    if (holderAddress) {
+        params['holder'] = holderAddress;
+    }
+    if (holderAddress) {
+        const envelope = await c.get(`/api/agents/token/${encodeURIComponent(address)}/holders`, params);
+        return envelope.data;
+    }
+    const envelope = await c.get(`/api/agents/token/${encodeURIComponent(address)}/holders`, params);
+    return envelope.data;
+}
+// ---------------------------------------------------------------------------
+// generateTradeLink
+// ---------------------------------------------------------------------------
+/**
+ * Generate a pre-filled trade URL for a human to open.
+ *
+ * The returned URL opens the trade page with the action and amount
+ * pre-filled so the user only needs to connect their wallet and confirm.
+ *
+ * Agents should share this link rather than attempting to sign transactions
+ * on behalf of users.
+ *
+ * @param address Token contract address
+ * @param action  'buy' or 'sell'
+ * @param amount  Optional pre-fill amount (FET for buys, token units for sells)
+ *
+ * @example
+ * ```ts
+ * const link = generateTradeLink('0xAbCd...', 'buy', 100);
+ * // https://agent-launch.ai/trade/0xAbCd...?action=buy&amount=100
+ * ```
+ */
+export function generateTradeLink(address, action, amount, client) {
+    const baseUrl = client?.baseUrl
+        ?? process.env['AGENT_LAUNCH_BASE_URL']?.replace(/\/$/, '')
+        ?? 'https://agent-launch.ai';
+    const params = new URLSearchParams({ action });
+    if (amount !== undefined && amount !== null) {
+        params.set('amount', String(amount));
+    }
+    return `${baseUrl}/trade/${address}?${params.toString()}`;
+}
+/**
+ * Overload that accepts a TradeLinkOptions object instead of positional args.
+ *
+ * @example
+ * ```ts
+ * const link = generateTradeLinkFromOptions('0xAbCd...', { action: 'sell', amount: 500 });
+ * ```
+ */
+export function generateTradeLinkFromOptions(address, options = {}, client) {
+    return generateTradeLink(address, options.action ?? 'buy', options.amount, client);
+}
+//# sourceMappingURL=market.js.map

package/dist/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAmBvC,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,aAAa;IACpB,OAAO,IAAI,iBAAiB,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAChF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,MAA0B;IAE1B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,aAAsB,EACtB,MAA0B;IAE1B,MAAM,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC;IACnC,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,GAAG,CAC1B,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAC1D,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,GAAG,CAC1B,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAC1D,MAAM,CACP,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,MAAmB,EACnB,MAAwB,EACxB,MAA0B;IAE1B,MAAM,OAAO,GAAI,MAA8D,EAAE,OAAO;WACnF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;WACxD,yBAAyB,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,OAAO,UAAU,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAe,EACf,UAA4B,EAAE,EAC9B,MAA0B;IAE1B,OAAO,iBAAiB,CACtB,OAAO,EACP,OAAO,CAAC,MAAM,IAAI,KAAK,EACvB,OAAO,CAAC,MAAM,EACd,MAAM,CACP,CAAC;AACJ,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @agent-launch/sdk — Token operations
+ *
+ * SDK-002: Wraps the token-related AgentLaunch API endpoints.
+ *
+ * All functions accept an optional AgentLaunchClient instance.  When omitted
+ * a default client is constructed from the AGENTVERSE_API_KEY and
+ * AGENT_LAUNCH_BASE_URL environment variables.
+ */
+import { AgentLaunchClient } from './client.js';
+import type { Token, TokenizeParams, TokenizeResponse, TokenListParams, TokenListResponse } from './types.js';
+/** Wrap the raw tokenize response envelope. */
+interface TokenizeEnvelope {
+    success: true;
+    data: TokenizeResponse;
+}
+/**
+ * Create a pending token record for an Agentverse agent.
+ *
+ * Only `agentAddress` is required — all other fields default to values
+ * fetched from Agentverse agent metadata.
+ *
+ * On success the returned `handoff_link` is a URL the human must open
+ * to complete the on-chain deployment (connect wallet → approve FET → deploy).
+ *
+ * Requires X-API-Key authentication.
+ *
+ * @example
+ * ```ts
+ * const { data } = await tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj5hxxkyd46c64qx...',
+ *   name: 'My Agent',
+ *   chainId: 97,
+ * });
+ * console.log(data.handoff_link); // https://agent-launch.ai/deploy/42
+ * ```
+ */
+export declare function tokenize(params: TokenizeParams, client?: AgentLaunchClient): Promise<TokenizeEnvelope>;
+/**
+ * Fetch a single token by its deployed contract address.
+ *
+ * The token must already be deployed (status = "bonding" or "listed").
+ * For pending tokens use the token ID instead.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * const token = await getToken('0xAbCd...');
+ * console.log(token.price, token.market_cap, token.progress);
+ * ```
+ */
+export declare function getToken(address: string, client?: AgentLaunchClient): Promise<Token>;
+/**
+ * List tokens on the platform with optional filtering and pagination.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * const { tokens } = await listTokens({ sortBy: 'market_cap', limit: 10 });
+ * ```
+ */
+export declare function listTokens(params?: TokenListParams, client?: AgentLaunchClient): Promise<TokenListResponse>;
+export {};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,+CAA+C;AAC/C,UAAU,gBAAgB;IACxB,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,KAAK,CAAC,CAGhB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,MAAM,GAAE,eAAoB,EAC5B,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/dist/tokens.js

@@ -0,0 +1,86 @@
+/**
+ * @agent-launch/sdk — Token operations
+ *
+ * SDK-002: Wraps the token-related AgentLaunch API endpoints.
+ *
+ * All functions accept an optional AgentLaunchClient instance.  When omitted
+ * a default client is constructed from the AGENTVERSE_API_KEY and
+ * AGENT_LAUNCH_BASE_URL environment variables.
+ */
+import { AgentLaunchClient } from './client.js';
+// ---------------------------------------------------------------------------
+// Module-level default client (lazy, env-based)
+// ---------------------------------------------------------------------------
+function defaultClient() {
+    return new AgentLaunchClient({
+        apiKey: process.env['AGENTVERSE_API_KEY'] ?? process.env['AGENT_LAUNCH_API_KEY'],
+        baseUrl: process.env['AGENT_LAUNCH_BASE_URL'],
+    });
+}
+// ---------------------------------------------------------------------------
+// tokenize
+// ---------------------------------------------------------------------------
+/**
+ * Create a pending token record for an Agentverse agent.
+ *
+ * Only `agentAddress` is required — all other fields default to values
+ * fetched from Agentverse agent metadata.
+ *
+ * On success the returned `handoff_link` is a URL the human must open
+ * to complete the on-chain deployment (connect wallet → approve FET → deploy).
+ *
+ * Requires X-API-Key authentication.
+ *
+ * @example
+ * ```ts
+ * const { data } = await tokenize({
+ *   agentAddress: 'agent1qf8xfhsc8hg4g5l0nhtj5hxxkyd46c64qx...',
+ *   name: 'My Agent',
+ *   chainId: 97,
+ * });
+ * console.log(data.handoff_link); // https://agent-launch.ai/deploy/42
+ * ```
+ */
+export async function tokenize(params, client) {
+    const c = client ?? defaultClient();
+    return c.post('/api/agents/tokenize', params);
+}
+// ---------------------------------------------------------------------------
+// getToken
+// ---------------------------------------------------------------------------
+/**
+ * Fetch a single token by its deployed contract address.
+ *
+ * The token must already be deployed (status = "bonding" or "listed").
+ * For pending tokens use the token ID instead.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * const token = await getToken('0xAbCd...');
+ * console.log(token.price, token.market_cap, token.progress);
+ * ```
+ */
+export async function getToken(address, client) {
+    const c = client ?? defaultClient();
+    return c.get(`/api/agents/token/${encodeURIComponent(address)}`);
+}
+// ---------------------------------------------------------------------------
+// listTokens
+// ---------------------------------------------------------------------------
+/**
+ * List tokens on the platform with optional filtering and pagination.
+ *
+ * No authentication required.
+ *
+ * @example
+ * ```ts
+ * const { tokens } = await listTokens({ sortBy: 'market_cap', limit: 10 });
+ * ```
+ */
+export async function listTokens(params = {}, client) {
+    const c = client ?? defaultClient();
+    return c.get('/api/agents/tokens', params);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAehD,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,aAAa;IACpB,OAAO,IAAI,iBAAiB,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAChF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,MAA0B;IAE1B,MAAM,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACpC,OAAO,CAAC,CAAC,IAAI,CAAmB,sBAAsB,EAAE,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,MAA0B;IAE1B,MAAM,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACpC,OAAO,CAAC,CAAC,GAAG,CAAQ,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAA0B,EAAE,EAC5B,MAA0B;IAE1B,MAAM,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACpC,OAAO,CAAC,CAAC,GAAG,CAAoB,oBAAoB,EAAE,MAA+D,CAAC,CAAC;AACzH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @agent-launch/sdk — TypeScript types
+ *
+ * SDK-006: Canonical types for all AgentLaunch API operations.
+ */
+/** Configuration passed to AgentLaunchClient on construction. */
+export interface AgentLaunchConfig {
+    /** Agentverse API key used as X-API-Key header on authenticated requests. */
+    apiKey?: string;
+    /**
+     * Base URL for the AgentLaunch platform.
+     * @default "https://agent-launch.ai"
+     */
+    baseUrl?: string;
+    /**
+     * Maximum number of retry attempts on HTTP 429 (rate limit) responses.
+     * Retries use exponential backoff: 1s, 2s, 4s, …
+     * @default 3
+     */
+    maxRetries?: number;
+}
+/** Typed error thrown by every SDK method on a non-2xx response. */
+export declare class AgentLaunchError extends Error {
+    /** HTTP status code returned by the server (0 if network-level failure). */
+    readonly status: number;
+    /** Original server message when available. */
+    readonly serverMessage: string | undefined;
+    constructor(message: string, status: number, serverMessage?: string);
+}
+/** Parameters for POST /agents/tokenize */
+export interface TokenizeParams {
+    /**
+     * Agentverse agent address (agent1q…) or Ethereum address (0x…).
+     * Required — this is the agent being tokenized.
+     */
+    agentAddress: string;
+    /**
+     * Token name (max 32 characters).
+     * When omitted the platform fetches the name from Agentverse metadata.
+     */
+    name?: string;
+    /**
+     * Token ticker symbol (max 11 characters, auto-uppercased).
+     * When omitted the platform derives it from the first 4 characters of name.
+     */
+    symbol?: string;
+    /**
+     * Token description (max 500 characters).
+     * When omitted an auto-generated description is used.
+     */
+    description?: string;
+    /**
+     * Token image: a public URL, a base64 data URI (data:image/…), or "auto"
+     * to request an auto-generated placeholder.
+     */
+    image?: string;
+    /**
+     * Agentverse-hosted avatar URL (https://agentverse.ai/…).
+     * Used when image is "auto" — preferred over the generated placeholder.
+     */
+    agentverse_avatar_url?: string;
+    /**
+     * Chain ID for deployment.
+     * Supported values: 56 (BSC Mainnet), 97 (BSC Testnet), 1 (ETH Mainnet), 11155111 (Sepolia).
+     * @default 11155111
+     */
+    chainId?: number;
+}
+/** Data returned by POST /agents/tokenize */
+export interface TokenizeResponse {
+    /** Database ID of the pending token record. Used to build handoff links. */
+    token_id: number;
+    /** Pre-built URL the human must open to complete on-chain deployment. */
+    handoff_link: string;
+    name: string;
+    symbol: string;
+    description: string;
+    /** Resolved token image URL. */
+    image: string;
+    /** "pending_deployment" until on-chain deploy is complete; "deployed" after. */
+    status: 'pending_deployment' | 'deployed';
+}
+/** A token as returned in list and detail responses. */
+export interface Token {
+    id: number;
+    name: string;
+    symbol: string;
+    /** Contract address — null while the token is pending deployment. */
+    address: string | null;
+    description: string;
+    logo: string;
+    /** Deployment status. */
+    status: 'pending' | 'bonding' | 'listed';
+    /** Current price in FET (string to preserve precision). */
+    price: string;
+    /** Market cap in FET (string). */
+    market_cap: string;
+    /** Bonding-curve progress toward 30,000 FET graduation (0–100). */
+    progress: number;
+    chainId: number;
+    creator?: string;
+    agentId?: string | null;
+    listed: boolean;
+    created_at: string;
+}
+/** Query parameters for GET /agents/tokens */
+export interface TokenListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    categoryId?: number;
+    chainId?: number;
+    sortBy?: string;
+    sortOrder?: 'ASC' | 'DESC';
+}
+/** Response from GET /agents/tokens */
+export interface TokenListResponse {
+    tokens: Token[];
+    /** Total count matching the query (before pagination). */
+    total?: number;
+    mainToken?: Token | null;
+}
+/** A single token holder entry. */
+export interface Holder {
+    address: string;
+    balance: string;
+    /** Percentage of total supply held (0–100). */
+    percentage?: number;
+}
+/** Response from GET /agents/token/:address/holders */
+export interface HolderListResponse {
+    holders: Holder[];
+    total: number;
+}
+/** Response when a single holder address is queried. */
+export interface SingleHolderResponse {
+    holder: Holder;
+}
+/** 'buy' or 'sell' — used in trade link generation. */
+export type TradeAction = 'buy' | 'sell';
+/** Options for trade link generation. */
+export interface TradeLinkOptions {
+    action?: TradeAction;
+    /** Pre-fill amount (FET for buys, token units for sells). */
+    amount?: number | string;
+}
+/** Response from POST /agents/auth */
+export interface AgentAuthResponse {
+    success: true;
+    data: {
+        token: string;
+        expires_in: number;
+    };
+}
+/** A single Agentverse agent entry returned by GET /agents/my-agents */
+export interface AgentverseAgent {
+    address: string;
+    name: string;
+    [key: string]: unknown;
+}
+/** Response from GET /agents/my-agents */
+export interface MyAgentsResponse {
+    success: true;
+    data: {
+        agents: AgentverseAgent[];
+        count: number;
+    };
+}
+/** Response from POST /agents/import-agentverse */
+export interface ImportAgentverseResponse {
+    agents: AgentverseAgent[];
+    count: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * @agent-launch/sdk — TypeScript types
+ *
+ * SDK-006: Canonical types for all AgentLaunch API operations.
+ */
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+/** Typed error thrown by every SDK method on a non-2xx response. */
+export class AgentLaunchError extends Error {
+    constructor(message, status, serverMessage) {
+        super(message);
+        this.name = 'AgentLaunchError';
+        this.status = status;
+        this.serverMessage = serverMessage;
+        // Restore prototype chain when targeting older runtimes
+        Object.setPrototypeOf(this, AgentLaunchError.prototype);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,oEAAoE;AACpE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAMzC,YAAY,OAAe,EAAE,MAAc,EAAE,aAAsB;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF"}