@loomlay/openclaw-wallet-sdk

TypeScript SDK for the LoomLay Agent API - wallet management, trading, and DEX data for AI agents.

Features

• Zero-config: Only API key required
• Fluent API: wallet.trading.swap(), wallet.dex.trending()
• Full TypeScript types: Complete type definitions for all endpoints
• Natural amounts: Supports "1.5", "$100", "50%", "max"
• Typed errors: Error classes with codes for proper handling
• Minimal deps: Native fetch only, no axios
• WebSocket support: Real-time DEX data and chain subscriptions

Installation

For AI Agents (via ClawHub)

clawhub install loomlay/openclaw-wallet

This installs the skill and makes all 27 tools available to your agent automatically.

For Programmatic Use (via npm)

npm install @loomlay/openclaw-wallet-sdk

Quick Start

import { OpenClawWallet } from '@loomlay/openclaw-wallet-sdk';

// Register for an API key (once per IP)
const { apiKey } = await OpenClawWallet.register();

// Create the client
const wallet = new OpenClawWallet({ apiKey });

// Create a wallet
const created = await wallet.wallet.create();
console.log('Seed phrase:', created.seedPhrase);

// Swap tokens
await wallet.trading.swap({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: '1.5'
});

API Reference

Initialization

import { OpenClawWallet } from '@loomlay/openclaw-wallet-sdk';

const wallet = new OpenClawWallet({
  apiKey: 'agent_xxx',           // Required
  baseUrl: 'https://api.loomlay.com', // Optional (default)
  timeout: 30000,                // Optional: request timeout in ms
  maxRetries: 3,                 // Optional: retry count
  retryDelay: 1000,              // Optional: base retry delay in ms
});

Registration

// Register for an API key (rate limited by IP)
const result = await OpenClawWallet.register();
console.log('API Key:', result.apiKey);
console.log('Account ID:', result.accountId);

Wallet Management

// Create a wallet
const created = await wallet.wallet.create();
// Returns: { wallet: { solanaAddress, evmAddress }, seedPhrase, message }

// Get wallet info and balances
const info = await wallet.wallet.get();
console.log('SOL balance:', info.balances.solana.sol);
console.log('ETH balance:', info.balances.evm.eth);

// Export private keys (requires seed phrase)
const keys = await wallet.wallet.exportKeys('your seed phrase here');
console.log('Solana key:', keys.solanaPrivateKey);
console.log('EVM key:', keys.evmPrivateKey);

Trading

Swaps

// Decimal amount
await wallet.trading.swap({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: '1.5'
});

// USD amount
await wallet.trading.swap({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: '$100'
});

// Percentage of balance
await wallet.trading.swap({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: '50%'
});

// Max (all tokens)
await wallet.trading.swap({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: 'max'
});

// Get quote without executing
const quote = await wallet.trading.getSwapQuote({
  inputToken: 'SOL',
  outputToken: 'USDC',
  amount: '1'
});
console.log('Output:', quote.outputAmount);
console.log('Price impact:', quote.priceImpact);

Transfers

await wallet.trading.transfer({
  token: 'SOL',
  amount: '0.1',
  to: 'recipient_address',
  chain: 'solana' // Optional, default: solana
});

Bridges

// Get bridge quote
const quote = await wallet.trading.getBridgeQuote({
  inputToken: 'SOL',
  amount: '1',
  sourceChain: 'solana',
  destinationChain: 'base'
});

// Execute bridge
const result = await wallet.trading.bridge({
  inputToken: 'SOL',
  amount: '1',
  sourceChain: 'solana',
  destinationChain: 'base'
});

Token Information

// Search tokens
const results = await wallet.tokens.search('BONK');

// Get token price
const price = await wallet.tokens.getPrice('SOL');
console.log('SOL price:', price.price);

// Get token details
const details = await wallet.tokens.getDetails('token_address');

// Get chart data
const chart = await wallet.tokens.getChart('token_address');

Portfolio

// Get combined portfolio
const portfolio = await wallet.portfolio.get();
console.log('Total value:', portfolio.totalUsdValue);

// Get transaction history
const history = await wallet.portfolio.getHistory({
  limit: 50,
  chain: 'solana' // Optional filter
});

DEX Data

// Get trending pairs
const trending = await wallet.dex.trending({
  chain: 'solana',
  minLiquidity: 10000,
  limit: 20
});

// Get top volume pairs
const volume = await wallet.dex.volume({ chain: 'solana' });

// Get gainers/losers
const gainers = await wallet.dex.gainers({ chain: 'solana' });
const losers = await wallet.dex.losers({ chain: 'solana' });

// Get new pairs (< 24h)
const newPairs = await wallet.dex.new({ chain: 'solana' });

// Get Pumpfun trending
const pumpfun = await wallet.dex.pumpfun({ maxAge: 24 });

// Advanced query
const results = await wallet.dex.query({
  chain: 'solana',
  timeframe: 'h24',
  rankBy: 'volume',
  order: 'desc',
  filters: {
    liquidity: { min: 50000 },
    volume24h: { min: 100000 }
  },
  minSafetyScore: 50,
  limit: 100
});

Token Launch

// Launch a token
const result = await wallet.tokenize.launch({
  name: 'My Token',
  symbol: 'MYT',
  tier: '100k', // Market cap tier
  imageUrl: 'https://...' // Optional
});
console.log('Token mint:', result.tokenMint);
console.log('Pool address:', result.poolAddress);

// Get launched token info
const info = await wallet.tokenize.getInfo();

Fee Management

// Get fee status
const status = await wallet.fees.getStatus();
console.log('Unclaimed fees:', status.beneficiaryFeesUnclaimedSol, 'SOL');
console.log('Can claim:', status.canClaim);

// Claim fees
const claim = await wallet.fees.claim();
console.log('Claimed:', claim.amountSol, 'SOL');

RPC Proxy

// Make RPC calls
const balance = await wallet.rpc.call('solana', 'getBalance', [address]);
console.log('Balance:', balance.result);

// Get supported chains
const chains = await wallet.rpc.getChains();

WebSocket: DEX Data

const dexWs = wallet.createDexWebSocket();
await dexWs.connect();

// Subscribe to trending pairs
const subId = await dexWs.subscribe(
  { chain: 'solana', minLiquidity: 10000 },
  (pairs) => console.log('Snapshot:', pairs.length, 'pairs'),
  (diff) => console.log('Update:', diff.added.length, 'new pairs')
);

// Unsubscribe
dexWs.unsubscribe(subId);
dexWs.disconnect();

WebSocket: Chain RPC

const chainWs = wallet.createChainWebSocket('solana');
await chainWs.connect();

// Make RPC call
const slot = await chainWs.call<number>('getSlot');

// Subscribe to updates
const subId = await chainWs.subscribe(
  'accountSubscribe',
  [address],
  (data) => console.log('Account changed:', data)
);

// Unsubscribe
await chainWs.unsubscribe(subId);
chainWs.disconnect();

Error Handling

import {
  ApiError,
  RateLimitError,
  NetworkError,
  TimeoutError,
  WebSocketError
} from '@loomlay/openclaw-wallet-sdk';

try {
  await wallet.trading.swap({ ... });
} catch (error) {
  if (error instanceof RateLimitError) {
    console.log('Rate limited, retry in', error.retryAfter, 'seconds');
  } else if (error instanceof ApiError) {
    console.log('API error:', error.message);
    console.log('Code:', error.code);
    console.log('Status:', error.status);
  } else if (error instanceof NetworkError) {
    console.log('Network error:', error.message);
  } else if (error instanceof TimeoutError) {
    console.log('Request timed out');
  }
}

Error Codes

| Code | Description | |------|-------------| | BAD_REQUEST | Invalid request parameters | | UNAUTHORIZED | Missing or invalid API key | | FORBIDDEN | Action not allowed | | NOT_FOUND | Resource not found | | CONFLICT | Resource already exists | | RATE_LIMITED | Too many requests | | INTERNAL_ERROR | Server error |

Supported Chains

| Chain | Swaps | Bridges | RPC | |-------|-------|---------|-----| | Solana | ✅ | ✅ | ✅ | | Ethereum | ✅ | ✅ | ✅ | | Base | ✅ | ✅ | ✅ | | Arbitrum | ✅ | ✅ | ✅ | | Optimism | ✅ | ✅ | ✅ | | Polygon | ✅ | ✅ | ✅ | | BSC | ✅ | ✅ | ✅ |

Amount Formats

The SDK accepts flexible amount formats:

| Format | Example | Description | |--------|---------|-------------| | Decimal | "1.5" | Direct amount | | USD | "$100" or "100usd" | Dollar amount (converted at current price) | | Percentage | "50%" | Percentage of balance | | Max | "max" or "all" | Entire balance |

Plugin Package

For AI agents that need native tool integration, use the plugin package:

# Via ClawHub (recommended for agents)
clawhub install loomlay/openclaw-wallet

# Via npm (for programmatic integration)
npm install @loomlay/openclaw-wallet-plugin

The plugin provides:

• 27 native tools - Ready-to-use functions for wallets, trading, DEX data, and token launches
• SKILL.md - Comprehensive training material for AI agents
• Standardized responses - Consistent { success, data, error } format

See plugin/README.md for full plugin documentation.

License

MIT