Examples & Use Cases

// Get blockchain information
const blockchainInfo = await neo.callTool('get_blockchain_info', {
  network: 'testnet'
});

console.log('Block count:', blockchainInfo.blockCount);
console.log('Latest height:', blockchainInfo.height);
console.log('Network:', blockchainInfo.network);

// Get the latest block by its numeric height
const block = await neo.callTool('get_block', {
  network: 'testnet',
  hashOrHeight: blockchainInfo.height
});

console.log('Latest block hash:', block.hash);
console.log('Transactions:', block.tx.length);

// Read metadata for a provisioned wallet
const wallet = await neo.callTool('get_wallet', {
  address: accountAddress
});

console.log('Wallet address:', wallet.address);

// Check wallet balance
const balance = await neo.callTool('get_balance', {
  address: wallet.address,
  network: 'testnet'
});

balance.balance.forEach(asset => {
  console.log(`${asset.asset_name}: ${asset.amount}`);
});

// Invoke a smart contract method
const result = await neo.callTool('invoke_contract', {
  network: 'testnet',
  contract: '0xd2a4cff31913016155e38e474a2c06d08be276cf',
  operation: 'symbol',
  args: []
});

console.log('Contract result:', result.stack[0].value);

// Inspect the live manifest before invoking another method
const status = await neo.callTool('get_contract_status', {
  network: 'testnet',
  contract: '0xd2a4cff31913016155e38e474a2c06d08be276cf'
});

console.log('Manifest:', status.manifestName);
console.log('Methods:', Object.keys(status.operations));

const reference = '0xd2a4cff31913016155e38e474a2c06d08be276cf';

const status = await neo.callTool('get_contract_status', {
  network: 'mainnet',
  contract: reference
});

if (!status.deployed) {
  throw new Error('Contract is not deployed on mainnet');
}

const info = await neo.callTool('get_contract_info', {
  network: 'mainnet',
  contract: reference
});

console.log('Resolved hash:', info.scriptHash);
console.log('Available methods:', Object.keys(status.operations));

// Transfer NEO tokens
const fee = await neo.callTool('estimate_transfer_fees', {
  network: 'testnet',
  fromAddress: 'NdUL5oDPD159KeFpD5A9zw5xNF1xLX6nLT',
  toAddress: 'NNLi44dJNXtDNSBkofB48aTVYtb1zZrNEs',
  asset: 'NEO',
  amount: '1'
});

console.log('Exact fees (datos):', fee.networkFeeDatos, fee.systemFeeDatos);
console.log('Formatted fees (GAS):', fee.networkFeeGas, fee.systemFeeGas);

const transfer = await neo.callTool('transfer_assets', {
  idempotencyKey: 'transfer-2026-07-11-002',
  network: 'testnet',
  toAddress: 'NNLi44dJNXtDNSBkofB48aTVYtb1zZrNEs',
  asset: 'NEO',
  amount: '1'
});

const txStatus = await neo.callTool('wait_for_transaction', {
  network: 'testnet',
  txid: transfer.txid,
  timeoutMs: 30000
});

console.log('Transaction confirmed:', txStatus.confirmed);

const txid = process.env.NEO_TXID;

const transaction = await neo.callTool('get_transaction', {
  network: 'mainnet',
  txid
});

const applicationLog = await neo.callTool('get_application_log', {
  network: 'mainnet',
  txid
});

console.log('Transaction:', transaction.hash);
for (const execution of applicationLog.executions) {
  console.log('VM state:', execution.vmstate);
  console.log('Notifications:', execution.notifications);
}