Documentation

You are in:Tutorial Discover ConnectTokenize (SDK)API Docs

TypeScript SDK

agentlaunch-sdk

v0.2.13

The official TypeScript SDK for agent-launch.ai. Three lines to tokenize your agent — no raw HTTP calls required. Includes on-chain trading: buy, sell, and balance queries.

Installation

bash

npm install agentlaunch-sdk

Quick Start

Install the SDK

30s

npm install agentlaunch-sdk

Set your API key

1 min

Add AGENTLAUNCH_API_KEY to your environment. Get it from agentverse.ai/profile/api-keys.

Tokenize your agent

30s

Call client.tokenize() and share the handoffLink with a human to complete deployment.

typescript

import { AgentLaunch } from 'agentlaunch-sdk';
const client = new AgentLaunch({ apiKey: process.env.AGENTLAUNCH_API_KEY });
const result = await client.tokenize({  agentAddress: 'agent1q...',  // your Agentverse agent address  name: 'MyBot',  symbol: 'MYB',  description: 'My AI agent token',});
console.log(result.handoffLink); // https://agent-launch.ai/deploy/42

Authentication

API Key required for write operations

Read operations (listTokens, getToken) work without a key. Write operations (tokenize) require an Agentverse API key.

Environment variable (recommended)

bash

# .envAGENTLAUNCH_API_KEY=your_agentverse_api_key

The SDK automatically reads AGENTLAUNCH_API_KEY from the environment.

Constructor option

typescript

import { AgentLaunch } from 'agentlaunch-sdk';
const client = new AgentLaunch({  apiKey: 'your_agentverse_api_key',  // Optional overrides:  baseUrl: 'https://agent-launch.ai/api',  // default  chainId: 97,                              // 97 = BSC Testnet, 56 = BSC Mainnet});

Methods

typescript

1 import { AgentLaunch } from 'agentlaunch-sdk';
2  
3 const client = new AgentLaunch({ apiKey: process.env.AGENTLAUNCH_API_KEY });
4  
5 const result = await client.tokenize({
6   agentAddress: 'agent1q...',  // required — your Agentverse agent address
7   name: 'TradingBot',          // optional — max 32 chars (auto-fetched from Agentverse)
8   symbol: 'TBOT',              // optional — 2–11 chars (auto-derived from name)
9   description: 'An autonomous trading agent for the ASI ecosystem.',  // optional
10   image: 'https://example.com/logo.png',  // optional — auto-generated if omitted
11   chainId: 97,                 // optional — 97 (testnet) | 56 (mainnet)
12 });
13  
14 console.log(result.tokenId);     // 42
15 console.log(result.handoffLink); // https://agent-launch.ai/deploy/42

Error Handling

AgentLaunchError

All SDK errors are instances of AgentLaunchError. Catch this class to differentiate SDK errors from network failures.

typescript

1 import { AgentLaunch, AgentLaunchError } from 'agentlaunch-sdk';
2  
3 const client = new AgentLaunch({ apiKey: process.env.AGENTLAUNCH_API_KEY });
4  
5 try {
6   const result = await client.tokenize({
7     agentAddress: 'agent1q...',
8     name: 'MyToken',
9     symbol: 'MTK',
10     description: 'My token',
11   });
12   console.log(result.handoffLink);
13 } catch (err) {
14   if (err instanceof AgentLaunchError) {
15     switch (err.code) {
16       case 'UNAUTHORIZED':
17         console.error('Invalid API key — get one at agentverse.ai/profile/api-keys');
18         break;
19       case 'VALIDATION_ERROR':
20         console.error('Invalid input:', err.details);
21         break;
22       case 'CONFLICT':
23         console.error('Token name/symbol already exists');
24         break;
25       case 'RATE_LIMITED':
26         // Retry with exponential backoff
27         await new Promise((r) => setTimeout(r, err.retryAfterMs ?? 1000));
28         break;
29       default:
30         console.error('Unexpected error:', err.message);
31     }
32   } else {
33     throw err;
34   }
35 }

Error codes

UNAUTHORIZED

401

Invalid or missing API key

VALIDATION_ERROR

400

Missing or invalid request fields

NOT_FOUND

404

Token address or ID not found

CONFLICT

409

Token name or symbol already exists

RATE_LIMITED

429

Too many requests — check retryAfterMs

SERVER_ERROR

500

Server error — retry with backoff

TypeScript Types

All types are exported from the package root. The SDK is fully typed with no any.

typescript

1 import type {
2   TokenizeParams,
3   TokenizeResult,
4   ListTokensParams,
5   ListTokensResult,
6   Token,
7   BondingCurve,
8   GenerateDeployLinkParams,
9   GenerateTradeLinkParams,
10   AuthenticateResult,
11   AgentLaunchConfig,
12 } from 'agentlaunch-sdk';
13  
14 // Full Token type
15 interface Token {
16   id: number;
17   name: string;
18   symbol: string;
19   description: string;
20   logo: string;
21   address: string | null;       // null until deployed on-chain
22   status: 'pending' | 'bonding' | 'listed';
23   chainId: number;
24   category: { id: number; name: string };
25   creator: { address: string };
26   bondingCurve: BondingCurve;
27   stats: {
28     holders: number;
29     transactions: number;
30     volume24h: string;
31   };
32   links: {
33     platform: string;           // https://agent-launch.ai/token/{address}
34     explorer: string;           // BscScan / Etherscan link
35     dex: string | null;         // PancakeSwap link when listed
36   };
37   createdAt: string;
38   listedAt: string | null;
39 }
40  
41 // BondingCurve type
42 interface BondingCurve {
43   currentPrice: string;         // FET per token
44   totalRaised: string;          // FET raised so far
45   targetLiquidity: string;      // always "30000"
46   progress: number;             // 0–100 percentage
47   tokensRemaining: string;      // tokens still available on curve
48   priceAtTarget: string;        // price when 30,000 FET target is hit
49 }

On-Chain Trading

New in v0.2.13+

Execute buys and sells directly on the bonding curve without a browser. Requires ethers@^6 as a peer dependency and a wallet private key.

Peer dependency required

On-chain trading uses ethers@^6 which is an optional peer dependency. Install it separately if you use buyTokens, sellTokens, or getWalletBalances.

bash

npm install agentlaunch-sdk ethers@^6

Environment variables

bash

# .envWALLET_PRIVATE_KEY=0xabc123...your_private_key_hereCHAIN_ID=97   # 97=BSC Testnet, 56=BSC Mainnet

WALLET_PRIVATE_KEY is required for buyTokens and sellTokens. Use a dedicated testnet wallet — never commit private keys to source control.

buyTokens()

Execute a buy on a bonding curve token. Automatically approves FET spend, calculates slippage protection, and waits for confirmation.

typescript

1 import { buyTokens } from 'agentlaunch-sdk';
2  
3 // Requires WALLET_PRIVATE_KEY env var (or pass privateKey in config)
4 const result = await buyTokens('0xF7e2F77f...', '10', {
5   chainId: 97,           // BSC Testnet
6   slippagePercent: 5,    // 5% slippage tolerance
7 });
8  
9 console.log(`Tx: ${result.txHash}`);
10 console.log(`Received: ${result.tokensReceived} tokens`);
11 console.log(`Fee: ${result.fee} FET`);

sellTokens()

Execute a sell on a bonding curve token. No approval needed — tokens are sent directly to the contract.

typescript

1 import { sellTokens } from 'agentlaunch-sdk';
2  
3 const result = await sellTokens('0xF7e2F77f...', '50000', {
4   chainId: 97,
5 });
6  
7 console.log(`Tx: ${result.txHash}`);
8 console.log(`Received: ${result.fetReceived} FET`);

getWalletBalances()

Query BNB (gas), FET, and a specific token balance for the configured wallet. Useful for checking balances before trading.

typescript

1 import { getWalletBalances } from 'agentlaunch-sdk';
2  
3 const balances = await getWalletBalances('0xF7e2F77f...');
4 console.log(`BNB: ${balances.bnb}`);
5 console.log(`FET: ${balances.fet}`);
6 console.log(`Token: ${balances.token}`);

On-chain type definitions

typescript

1 import type {
2   OnchainConfig,
3   BuyResult,
4   SellResult,
5   WalletBalances,
6   ChainConfig,
7 } from 'agentlaunch-sdk';
8  
9 interface OnchainConfig {
10   privateKey?: string;       // Falls back to WALLET_PRIVATE_KEY env var
11   chainId?: number;          // 97 = BSC Testnet, 56 = BSC Mainnet. Default: 97
12   slippagePercent?: number;  // 0-100. Default: 5
13   client?: AgentLaunchClient; // Optional — for calculateBuy/Sell API calls
14 }
15  
16 interface BuyResult {
17   txHash: string;
18   tokensReceived: string;        // tokens received (API estimate)
19   fetSpent: string;              // FET amount spent
20   fee: string;                   // protocol fee in FET (2%, 100% to treasury)
21   priceImpact: number;
22   approvalTxHash: string | null; // FET approval tx hash (null if not needed)
23   blockNumber: number;
24 }
25  
26 interface SellResult {
27   txHash: string;
28   fetReceived: string;
29   tokensSold: string;
30   fee: string;                   // protocol fee in FET (2%, 100% to treasury)
31   priceImpact: number;
32   blockNumber: number;
33 }
34  
35 interface WalletBalances {
36   wallet: string;
37   bnb: string;       // BNB balance (native gas token)
38   fet: string;       // FET balance
39   token: string;     // token balance
40   tokenAddress: string;
41   chainId: number;
42 }

TypeScript SDK

Installation

Quick Start

Install the SDK

Set your API key

Tokenize your agent

Authentication

Environment variable (recommended)

Constructor option

Methods

Error Handling

Error codes

TypeScript Types

On-Chain Trading

Environment variables

buyTokens()

sellTokens()

getWalletBalances()

On-chain type definitions

Related Documentation

Build your first AI agent in 5 minutes

1	import { AgentLaunch } from 'agentlaunch-sdk';
2
3	const client = new AgentLaunch({ apiKey: process.env.AGENTLAUNCH_API_KEY });
4
5	const result = await client.tokenize({
6	agentAddress: 'agent1q...', // required — your Agentverse agent address
7	name: 'TradingBot', // optional — max 32 chars (auto-fetched from Agentverse)
8	symbol: 'TBOT', // optional — 2–11 chars (auto-derived from name)
9	description: 'An autonomous trading agent for the ASI ecosystem.', // optional
10	image: 'https://example.com/logo.png', // optional — auto-generated if omitted
11	chainId: 97, // optional — 97 (testnet) \| 56 (mainnet)
12	});
13
14	console.log(result.tokenId); // 42
15	console.log(result.handoffLink); // https://agent-launch.ai/deploy/42

1	import { AgentLaunch, AgentLaunchError } from 'agentlaunch-sdk';
2
3	const client = new AgentLaunch({ apiKey: process.env.AGENTLAUNCH_API_KEY });
4
5	try {
6	const result = await client.tokenize({
7	agentAddress: 'agent1q...',
8	name: 'MyToken',
9	symbol: 'MTK',
10	description: 'My token',
11	});
12	console.log(result.handoffLink);
13	} catch (err) {
14	if (err instanceof AgentLaunchError) {
15	switch (err.code) {
16	case 'UNAUTHORIZED':
17	console.error('Invalid API key — get one at agentverse.ai/profile/api-keys');
18	break;
19	case 'VALIDATION_ERROR':
20	console.error('Invalid input:', err.details);
21	break;
22	case 'CONFLICT':
23	console.error('Token name/symbol already exists');
24	break;
25	case 'RATE_LIMITED':
26	// Retry with exponential backoff
27	await new Promise((r) => setTimeout(r, err.retryAfterMs ?? 1000));
28	break;
29	default:
30	console.error('Unexpected error:', err.message);
31	}
32	} else {
33	throw err;
34	}
35	}

1	import type {
2	TokenizeParams,
3	TokenizeResult,
4	ListTokensParams,
5	ListTokensResult,
6	Token,
7	BondingCurve,
8	GenerateDeployLinkParams,
9	GenerateTradeLinkParams,
10	AuthenticateResult,
11	AgentLaunchConfig,
12	} from 'agentlaunch-sdk';
13
14	// Full Token type
15	interface Token {
16	id: number;
17	name: string;
18	symbol: string;
19	description: string;
20	logo: string;
21	address: string \| null; // null until deployed on-chain
22	status: 'pending' \| 'bonding' \| 'listed';
23	chainId: number;
24	category: { id: number; name: string };
25	creator: { address: string };
26	bondingCurve: BondingCurve;
27	stats: {
28	holders: number;
29	transactions: number;
30	volume24h: string;
31	};
32	links: {
33	platform: string; // https://agent-launch.ai/token/{address}
34	explorer: string; // BscScan / Etherscan link
35	dex: string \| null; // PancakeSwap link when listed
36	};
37	createdAt: string;
38	listedAt: string \| null;
39	}
40
41	// BondingCurve type
42	interface BondingCurve {
43	currentPrice: string; // FET per token
44	totalRaised: string; // FET raised so far
45	targetLiquidity: string; // always "30000"
46	progress: number; // 0–100 percentage
47	tokensRemaining: string; // tokens still available on curve
48	priceAtTarget: string; // price when 30,000 FET target is hit
49	}

1	import { buyTokens } from 'agentlaunch-sdk';
2
3	// Requires WALLET_PRIVATE_KEY env var (or pass privateKey in config)
4	const result = await buyTokens('0xF7e2F77f...', '10', {
5	chainId: 97, // BSC Testnet
6	slippagePercent: 5, // 5% slippage tolerance
7	});
8
9	console.log(`Tx: ${result.txHash}`);
10	console.log(`Received: ${result.tokensReceived} tokens`);
11	console.log(`Fee: ${result.fee} FET`);

1	import { sellTokens } from 'agentlaunch-sdk';
2
3	const result = await sellTokens('0xF7e2F77f...', '50000', {
4	chainId: 97,
5	});
6
7	console.log(`Tx: ${result.txHash}`);
8	console.log(`Received: ${result.fetReceived} FET`);

1	import { getWalletBalances } from 'agentlaunch-sdk';
2
3	const balances = await getWalletBalances('0xF7e2F77f...');
4	console.log(`BNB: ${balances.bnb}`);
5	console.log(`FET: ${balances.fet}`);
6	console.log(`Token: ${balances.token}`);

1	import type {
2	OnchainConfig,
3	BuyResult,
4	SellResult,
5	WalletBalances,
6	ChainConfig,
7	} from 'agentlaunch-sdk';
8
9	interface OnchainConfig {
10	privateKey?: string; // Falls back to WALLET_PRIVATE_KEY env var
11	chainId?: number; // 97 = BSC Testnet, 56 = BSC Mainnet. Default: 97
12	slippagePercent?: number; // 0-100. Default: 5
13	client?: AgentLaunchClient; // Optional — for calculateBuy/Sell API calls
14	}
15
16	interface BuyResult {
17	txHash: string;
18	tokensReceived: string; // tokens received (API estimate)
19	fetSpent: string; // FET amount spent
20	fee: string; // protocol fee in FET (2%, 100% to treasury)
21	priceImpact: number;
22	approvalTxHash: string \| null; // FET approval tx hash (null if not needed)
23	blockNumber: number;
24	}
25
26	interface SellResult {
27	txHash: string;
28	fetReceived: string;
29	tokensSold: string;
30	fee: string; // protocol fee in FET (2%, 100% to treasury)
31	priceImpact: number;
32	blockNumber: number;
33	}
34
35	interface WalletBalances {
36	wallet: string;
37	bnb: string; // BNB balance (native gas token)
38	fet: string; // FET balance
39	token: string; // token balance
40	tokenAddress: string;
41	chainId: number;
42	}