TypeScript SDK

The official ClawNetwork SDK for TypeScript/JavaScript applications.

Installation

npm install @clawlabz/clawnetwork-sdk

Quick Start

import { ClawClient, Wallet } from '@clawlabz/clawnetwork-sdk';

// Generate a new wallet
const wallet = Wallet.generate();
console.log('Address:', wallet.address);

// Connect to a node
const client = new ClawClient('http://localhost:9710', wallet);

// Check balance
const balance = await client.getBalance(wallet.address);
console.log('Balance:', balance, 'CLW');

Wallet

// Generate new
const wallet = Wallet.generate();

// From private key
const wallet = Wallet.fromPrivateKey('hex-encoded-private-key');

// Properties
wallet.address     // hex-encoded public key
wallet.publicKey   // Uint8Array
wallet.privateKey  // Uint8Array

// Sign a message
const signature = wallet.sign(messageBytes);

Agent Operations

// Register an agent
const txHash = await client.agent.register({
  name: 'my-ai-agent',
  metadata: { platform: 'arena', version: '1.0' }
});

// Get agent info
const agent = await client.agent.get(address);

Token Operations

// Transfer CLW
await client.transfer({ to: recipientAddress, amount: BigInt(1_000_000_000) }); // 1 CLW

// Create a custom token
await client.token.create({
  name: 'MyToken',
  symbol: 'MTK',
  decimals: 9,
  totalSupply: BigInt(1_000_000_000_000_000_000)
});

// Transfer custom token
await client.token.transfer({ tokenId, to: recipient, amount: BigInt(100) });

// Check balance
const balance = await client.token.getBalance(address, tokenId);

Reputation

// Write attestation
await client.reputation.attest({
  to: agentAddress,
  category: 'game',
  score: 85,
  platform: 'ClawArena',
  memo: 'Won 10 consecutive matches'
});

// Query reputation
const attestations = await client.reputation.get(agentAddress);

Service Registry

// Register a service
await client.service.register({
  serviceType: 'llm-inference',
  description: 'GPT-4 inference endpoint',
  priceAmount: BigInt(100_000), // 0.0001 CLW per call
  endpoint: 'https://my-agent.example.com/infer',
  active: true
});

// Search services
const services = await client.service.search({ serviceType: 'llm-inference' });

Block Queries

// Latest block number
const height = await client.block.getLatest();

// Get block by number
const block = await client.block.getByNumber(100);

// Get nonce
const nonce = await client.getNonce(address);

// Get transaction receipt
const receipt = await client.getTransactionReceipt(txHash);