GizaAgent Client

import { GizaAgent, Chain } from '@giza/agent-sdk';

const giza = new GizaAgent(config);

GIZA_API_KEY=...      # Required
GIZA_API_URL=...    # Required
GIZA_PARTNER_NAME=...    # Required

import { GizaAgent, Chain } from '@giza/agent-sdk';

// Basic initialization
const giza = new GizaAgent({
  chainId: Chain.BASE,
});

// With custom options
const gizaCustom = new GizaAgent({
  chainId: Chain.ARBITRUM,
  timeout: 60000,      // 60 second timeout
  enableRetry: true,   // Retry failed requests
  agentId: 'custom_v1', // Custom agent ID
});

const chainId = giza.getChainId();
console.log('Operating on chain:', chainId); // 8453 or 42161

const url = giza.getBackendUrl();
console.log('API URL:', url); // https://api.giza.tech

const agentId = giza.getAgentId();
console.log('Agent ID:', agentId);

const config = giza.getConfig();
console.log('Configuration:', config);

// Create smart account
const account = await giza.agent.createSmartAccount({
  origin_wallet: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
});

// Activate agent
await giza.agent.activate({
  wallet: account.smartAccountAddress,
  origin_wallet: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  initial_token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
  selected_protocols: ['aave', 'compound'],
});

// Get performance
const performance = await giza.agent.getPerformance({
  wallet: account.smartAccountAddress
});

// Withdraw
await giza.agent.withdraw({
  wallet: account.smartAccountAddress,
  transfer: true
});

const result = await giza.optimizer.optimize({
  chainId: Chain.BASE,
  total_capital: "1000000000",
  token_address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  current_allocations: {
    aave: "500000000",
    compound: "500000000"
  },
  protocols: ["aave", "compound", "moonwell"],
});

console.log('Optimal allocation:', result.optimization_result.allocations);
console.log('APR improvement:', result.optimization_result.apr_improvement);

import {
  ValidationError,
  GizaAPIError,
  TimeoutError,
  NotImplementedError
} from '@giza/agent-sdk';

try {
  const account = await giza.agent.createSmartAccount({
    origin_wallet: userWallet
  });
} catch (error) {
  if (error instanceof ValidationError) {
    // Input validation failed
    console.error('Invalid input:', error.message);
  } else if (error instanceof GizaAPIError) {
    // API error (4xx, 5xx)
    console.error('API error:', error.statusCode, error.message);
    console.error('Details:', error.details);
  } else if (error instanceof TimeoutError) {
    // Request timed out
    console.error('Request timed out');
  } else if (error instanceof NotImplementedError) {
    // Feature not yet implemented
    console.error('Not implemented:', error.message);
  } else {
    // Unexpected error
    console.error('Unexpected error:', error);
  }
}

import type {
  SmartAccountInfo,
  ActivateParams,
  PerformanceChartResponse,
  WithdrawParams,
  OptimizeParams,
  // ... and many more
} from '@giza/agent-sdk';

// Type-safe parameters
const activateParams: ActivateParams = {
  wallet: account.smartAccountAddress,
  origin_wallet: userWallet,
  initial_token: USDC_ADDRESS,
  selected_protocols: ['aave', 'compound'],
};

await giza.agent.activate(activateParams);

import { Chain, CHAIN_NAMES } from '@giza/agent-sdk';

// Supported chains
console.log(Chain.BASE);      // 8453
console.log(Chain.ARBITRUM);  // 42161

// Chain names
console.log(CHAIN_NAMES[Chain.BASE]);      // 'Base'
console.log(CHAIN_NAMES[Chain.ARBITRUM]);  // 'Arbitrum'

// Use with constructor
const gizaBase = new GizaAgent({ chainId: Chain.BASE });
const gizaArb = new GizaAgent({ chainId: Chain.ARBITRUM });