@zoguxprotocol/client-js 0.2.0

package/examples/json-encoding.ts

@@ -0,0 +1,33 @@
+import BigNumber from 'bignumber.js';
+import Long from 'long';
+
+import { encodeJson } from '../src/lib/helpers';
+
+const longValue = Long.fromInt(1, true);
+const objWithLong = {
+  longValue,
+};
+
+const jsonedWithLong = encodeJson(objWithLong);
+console.log(jsonedWithLong);
+
+const bigNumberValue = BigNumber(1);
+const objWithBigNumber = {
+  bigNumberValue,
+};
+const jsonedWithBigNumber = encodeJson(objWithBigNumber);
+console.log(jsonedWithBigNumber);
+
+const buffer = Buffer.from('this is a tést');
+const objWithBuffer = {
+  buffer,
+};
+
+// Object.keys(objWithBuffer).forEach((k) => {
+//   console.log(k, objWithBuffer[k]); // ERROR!!
+// });
+const isBuffer2 = objWithBuffer.buffer instanceof Uint8Array;
+console.log(isBuffer2);
+
+const jsonedWithBuffer = encodeJson(objWithBuffer);
+console.log(jsonedWithBuffer);

package/examples/long_term_order_cancel_example.ts

@@ -0,0 +1,87 @@
+import { BECH32_PREFIX, OrderFlags } from '../src';
+import { CompositeClient } from '../src/clients/composite-client';
+import {
+  Network,
+  OrderExecution,
+  OrderSide,
+  OrderTimeInForce,
+  OrderType,
+} from '../src/clients/constants';
+import LocalWallet from '../src/clients/modules/local-wallet';
+import { SubaccountInfo } from '../src/clients/subaccount';
+import { randomInt } from '../src/lib/utils';
+import { ZOGUX_TEST_MNEMONIC, MAX_CLIENT_ID } from './constants';
+
+async function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function test(): Promise<void> {
+  const wallet = await LocalWallet.fromMnemonic(ZOGUX_TEST_MNEMONIC, BECH32_PREFIX);
+  console.log(wallet);
+  const network = Network.testnet();
+  const client = await CompositeClient.connect(network);
+  console.log('**Client**');
+  console.log(client);
+  const subaccount = SubaccountInfo.forLocalWallet(wallet, 0);
+
+  /*
+  Note this example places a stateful order.
+  Programmatic traders should generally not use stateful orders for following reasons:
+  - Stateful orders received out of order by validators will fail sequence number validation
+    and be dropped.
+  - Stateful orders have worse time priority since they are only matched after they are included
+    on the block.
+  - Stateful order rate limits are more restrictive than Short-Term orders, specifically max 2 per
+    block / 20 per 100 blocks.
+  - Stateful orders can only be canceled after they’ve been included in a block.
+  */
+  const longTermOrderClientId = randomInt(MAX_CLIENT_ID);
+  try {
+    // place a long term order
+    const tx = await client.placeOrder(
+      subaccount,
+      'ETH-USD',
+      OrderType.LIMIT,
+      OrderSide.SELL,
+      40000,
+      0.01,
+      longTermOrderClientId,
+      OrderTimeInForce.GTT,
+      60,
+      OrderExecution.DEFAULT,
+      false,
+      false,
+    );
+    console.log('**Long Term Order Tx**');
+    console.log(tx.hash);
+  } catch (error) {
+    console.log('**Long Term Order Failed**');
+    console.log(error.message);
+  }
+
+  await sleep(5000); // wait for placeOrder to complete
+
+  try {
+    // cancel the long term order
+    const tx = await client.cancelOrder(
+      subaccount,
+      longTermOrderClientId,
+      OrderFlags.LONG_TERM,
+      'ETH-USD',
+      0,
+      120,
+    );
+    console.log('**Cancel Long Term Order Tx**');
+    console.log(tx);
+  } catch (error) {
+    console.log('**Cancel Long Term Order Failed**');
+    console.log(error.message);
+  }
+}
+
+test()
+  .then(() => {})
+  .catch((error) => {
+    console.log(error.message);
+  });

package/examples/markets_endpoints.ts

@@ -0,0 +1,134 @@
+/**
+ * Simple JS example demostrating accessing market data with Indexer REST endpoints
+ */
+
+import { Network } from '../src/clients/constants';
+import { IndexerClient } from '../src/clients/indexer-client';
+
+// ------------ Markets ------------
+export const MARKET_BTC_USD: string = 'BTC-USD';
+
+async function test(): Promise<void> {
+  const client = new IndexerClient(Network.testnet().indexerConfig);
+
+  // Get perp markets
+  try {
+    const response = await client.markets.getPerpetualMarkets();
+    console.log(response);
+    console.log('markets');
+    const btcMarket = response.markets['BTC-USD'];
+    const btcMarketStatus = btcMarket.status;
+    console.log(btcMarketStatus);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  try {
+    const response = await client.markets.getPerpetualMarkets(MARKET_BTC_USD);
+    console.log(response);
+    console.log('markets');
+    const btcMarket = response.markets['BTC-USD'];
+    const btcMarketStatus = btcMarket.status;
+    console.log(btcMarketStatus);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // Get sparklines
+  try {
+    const response = await client.markets.getPerpetualMarketSparklines();
+    console.log(response);
+    console.log('sparklines');
+    const btcSparklines = response['BTC-USD'];
+    console.log(btcSparklines);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // Get perp market trades
+  try {
+    const response = await client.markets.getPerpetualMarketTrades(MARKET_BTC_USD);
+    console.log(response);
+    console.log('trades');
+    const trades = response.trades;
+    console.log(trades);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // Get perp market orderbook
+  try {
+    const response = await client.markets.getPerpetualMarketOrderbook(MARKET_BTC_USD);
+    console.log(response);
+    console.log('orderbook');
+    const asks = response.asks;
+    const bids = response.bids;
+    if (asks.length > 0) {
+      const asks0 = asks[0];
+      const asks0Price = asks0.price;
+      const asks0Size = asks0.size;
+      console.log(asks0Price);
+      console.log(asks0Size);
+    }
+    if (bids.length > 0) {
+      const bids0 = bids[0];
+      const bids0Price = bids0.price;
+      const bids0Size = bids0.size;
+      console.log(bids0Price);
+      console.log(bids0Size);
+    }
+    const trades = response.trades;
+    console.log(trades);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // Get perp market candles
+  try {
+    const response = await client.markets.getPerpetualMarketCandles(MARKET_BTC_USD, '1MIN');
+    console.log(response);
+    console.log('candles');
+    const candles = response.candles;
+    if (candles.length > 0) {
+      const candles0 = candles[0];
+      const startedAt = candles0.startedAt;
+      const low = candles0.low;
+      const high = candles0.high;
+      const open = candles0.open;
+      const close = candles0.close;
+      const baseTokenVolume = candles0.baseTokenVolume;
+      const usdVolume = candles0.usdVolume;
+      const trades = candles0.trades;
+      console.log(startedAt);
+      console.log(low);
+      console.log(high);
+      console.log(open);
+      console.log(close);
+      console.log(baseTokenVolume);
+      console.log(usdVolume);
+      console.log(trades);
+    }
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // Get perp market historical funding rates
+  try {
+    const response = await client.markets.getPerpetualMarketHistoricalFunding(MARKET_BTC_USD);
+    console.log(response);
+    console.log('historical funding');
+    const historicalFunding = response.historicalFunding;
+    if (historicalFunding.length > 0) {
+      const historicalFunding0 = historicalFunding[0];
+      console.log(historicalFunding0);
+    }
+  } catch (error) {
+    console.log(error.message);
+  }
+}
+
+test()
+  .then(() => {})
+  .catch((error) => {
+    console.log(error.message);
+  });

package/examples/native_examples.ts

@@ -0,0 +1,151 @@
+import { Network } from '../src/clients/constants';
+import { UserError } from '../src/clients/lib/errors';
+import {
+  connect,
+  connectWallet,
+  deposit,
+  faucet,
+  getAccountBalances,
+  getOptimalNode,
+  getUserStats,
+  simulateDeposit,
+  simulateTransferNativeToken,
+  simulateWithdraw,
+  transferNativeToken,
+  withdraw,
+  withdrawToIBC,
+  wrappedError,
+  getMegavaultOwnerShares,
+  depositToMegavault,
+  withdrawFromMegavault,
+} from '../src/clients/native';
+import { ZOGUX_TEST_ADDRESS, ZOGUX_TEST_MNEMONIC } from './constants';
+
+async function test(): Promise<void> {
+  try {
+    const paramsInJson = `{
+      "endpointUrls":[
+        "https://zogux-testnet.nodefleet.org",
+        "https://test-zogux-rpc.kingnodes.com",
+        "https://zogux-rpc.liquify.com/api=8878132/zogux"
+      ],
+      "chainId":"zogux-testnet-1"
+    }`;
+    const result = await getOptimalNode(paramsInJson);
+    console.log(result);
+
+    const wallet = await connectWallet(ZOGUX_TEST_MNEMONIC);
+    console.log(wallet);
+
+    const params3 = `
+    {"subaccountNumber":0,"amount":100.0}
+    `;
+    const result3 = await faucet(params3);
+    console.log(result3);
+
+    const address = await connect(Network.testnet(), ZOGUX_TEST_MNEMONIC);
+    console.log(address);
+
+    const payload = `{ "address": "${ZOGUX_TEST_ADDRESS}" }`;
+    const userStats = await getUserStats(payload);
+    console.log(userStats);
+
+    const balances1 = await getAccountBalances();
+    console.log(balances1);
+
+    const vaultOwnerShares = await getMegavaultOwnerShares(payload);
+    console.log(vaultOwnerShares);
+    
+    const depositResult = await depositToMegavault(0, 2);
+    console.log(depositResult);
+
+    const withdrawResult = await withdrawFromMegavault(0, 1, 0);
+    console.log(withdrawResult);
+
+
+    const sendTokenPayload = {
+      subaccountNumber: 0,
+      amount: '10', // Zogux Token
+      recipient: 'zogux15ndn9c895f8ntck25qughtuck9spv2d9svw5qx',
+    };
+    const fees = await simulateTransferNativeToken(JSON.stringify(sendTokenPayload));
+    console.log(fees);
+
+    let tx = await transferNativeToken(JSON.stringify(sendTokenPayload));
+    console.log(tx);
+
+    let balances = await getAccountBalances();
+    console.log(balances);
+
+    const simulatePayload = {
+      subaccountNumber: 0,
+      amount: 20, // In USDC i.e. $20.00
+    };
+    let stdFee = await simulateWithdraw(JSON.stringify(simulatePayload));
+    console.log(stdFee);
+
+    const withdrawlPayload = {
+      subaccountNumber: 0,
+      amount: 20,
+    };
+    tx = await withdraw(JSON.stringify(withdrawlPayload));
+    console.log(tx);
+
+    balances = await getAccountBalances();
+    console.log(balances);
+
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+
+    const depositPayload = {
+      subaccountNumber: 0,
+      amount: 20,
+    };
+    const stringVal = JSON.stringify(depositPayload);
+
+    stdFee = await simulateDeposit(stringVal);
+    console.log(stdFee);
+
+    tx = await deposit(stringVal);
+    console.log(tx);
+
+    const squidPayload = `
+    {
+      "msgTypeUrl": "/ibc.applications.transfer.v1.MsgTransfer",
+      "msg": {
+          "sourcePort": "transfer",
+          "sourceChannel": "channel-0",
+          "token": {
+              "denom": "ibc/8E27BA2D5493AF5636760E354E46004562C46AB7EC0CC4C1CA14E9E20E2545B5",
+              "amount": "10000000"
+          },
+          "sender": "zogux16zfx8g4jg9vels3rsvcym490tkn5la304c57e9",
+          "receiver": "noble16zfx8g4jg9vels3rsvcym490tkn5la305z0jpu",
+          "timeoutTimestamp": {
+              "low": -1208865792,
+              "high": 393844701,
+              "unsigned": false
+          },
+          "memo": "{\\"forward\\":{\\"receiver\\":\\"osmo1zl9ztmwe2wcdvv9std8xn06mdaqaqm789rutmazfh3z869zcax4sv0ctqw\\",\\"port\\":\\"transfer\\",\\"channel\\":\\"channel-10\\",\\"next\\":{\\"wasm\\":{\\"contract\\":\\"osmo1zl9ztmwe2wcdvv9std8xn06mdaqaqm789rutmazfh3z869zcax4sv0ctqw\\",\\"msg\\":{\\"swap_with_action\\":{\\"swap_msg\\":{\\"token_out_min_amount\\":\\"26039154\\",\\"path\\":[{\\"pool_id\\":\\"46\\",\\"token_out_denom\\":\\"ibc/6F34E1BD664C36CE49ACC28E60D62559A5F96C4F9A6CCE4FC5A67B2852E24CFE\\"}]},\\"after_swap_action\\":{\\"ibc_transfer\\":{\\"receiver\\":\\"axelar1dv4u5k73pzqrxlzujxg3qp8kvc3pje7jtdvu72npnt5zhq05ejcsn5qme5\\",\\"channel\\":\\"channel-3\\",\\"next_memo\\":{\\"destination_chain\\":\\"ethereum-2\\",\\"destination_address\\":\\"0x481A2AAE41cd34832dDCF5A79404538bb2c02bC8\\",\\"payload\\":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,64,0,0,0,0,0,0,0,0,0,0,0,0,49,218,140,19,124,78,181,10,51,8,133,105,138,128,201,57,254,53,175,138,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,96,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,96,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,224,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,160,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,192,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,0,0,0,0,0,0,0,0,0,0,0,0,37,77,6,243,59,220,91,142,224,91,46,164,114,16,126,48,2,38,101,154,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,37,77,6,243,59,220,91,142,224,91,46,164,114,16,126,48,2,38,101,154,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,160,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,32,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,68,9,94,167,179,0,0,0,0,0,0,0,0,0,0,0,0,122,37,13,86,48,180,207,83,151,57,223,44,93,172,180,198,89,242,72,141,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,64,0,0,0,0,0,0,0,0,0,0,0,0,37,77,6,243,59,220,91,142,224,91,46,164,114,16,126,48,2,38,101,154,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,122,37,13,86,48,180,207,83,151,57,223,44,93,172,180,198,89,242,72,141,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,160,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,224,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,24,203,175,229,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,148,53,113,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,29,55,213,140,136,107,36,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,160,0,0,0,0,0,0,0,0,0,0,0,0,49,218,140,19,124,78,181,10,51,8,133,105,138,128,201,57,254,53,175,138,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,137,180,65,29,110,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,37,77,6,243,59,220,91,142,224,91,46,164,114,16,126,48,2,38,101,154,0,0,0,0,0,0,0,0,0,0,0,0,180,251,242,113,20,63,79,191,123,145,165,222,211,24,5,228,43,34,8,214,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,64,0,0,0,0,0,0,0,0,0,0,0,0,37,77,6,243,59,220,91,142,224,91,46,164,114,16,126,48,2,38,101,154,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],\\"type\\":2}}},\\"local_fallback_address\\":\\"osmo16zfx8g4jg9vels3rsvcym490tkn5la3056f20q\\"}}}}}}"
+      }
+  }`;
+    console.log(squidPayload);
+
+    const encode = (str: string): string => Buffer.from(str, 'binary').toString('base64');
+    const encoded = encode(squidPayload);
+
+    tx = await withdrawToIBC(0, '13', encoded);
+    console.log(tx);
+  } catch (error) {
+    console.log(error.message);
+  }
+}
+
+test()
+  .then(() => {})
+  .catch((error) => {
+    console.log(error.message);
+  });
+
+const error = new UserError('client is not connected. Call connectClient() first');
+const text = wrappedError(error);
+console.log(text);

package/examples/noble_example.ts

@@ -0,0 +1,107 @@
+import { EncodeObject } from '@cosmjs/proto-signing';
+import Long from 'long';
+
+import { SubaccountInfo } from '../src';
+import { Network } from '../src/clients/constants';
+import LocalWallet from '../src/clients/modules/local-wallet';
+import { NobleClient } from '../src/clients/noble-client';
+import { ValidatorClient } from '../src/clients/validator-client';
+import { BECH32_PREFIX, NOBLE_BECH32_PREFIX } from '../src/lib/constants';
+import { sleep } from '../src/lib/utils';
+import { ZOGUX_TEST_MNEMONIC } from './constants';
+
+async function test(): Promise<void> {
+  const zoguxClient = await ValidatorClient.connect(Network.testnet().validatorConfig);
+
+  const zoguxWallet = await LocalWallet.fromMnemonic(ZOGUX_TEST_MNEMONIC, BECH32_PREFIX);
+  const nobleWallet = await LocalWallet.fromMnemonic(ZOGUX_TEST_MNEMONIC, NOBLE_BECH32_PREFIX);
+
+  const client = new NobleClient('https://rpc.testnet.noble.strange.love', 'Noble example');
+  await client.connect(nobleWallet);
+
+  if (nobleWallet.address === undefined || zoguxWallet.address === undefined) {
+    throw new Error('Wallet not found');
+  }
+
+  // IBC to noble
+
+  const ibcToNobleMsg: EncodeObject = {
+    typeUrl: '/ibc.applications.transfer.v1.MsgTransfer',
+    value: {
+      sourcePort: 'transfer',
+      sourceChannel: 'channel-0',
+      token: {
+        denom: 'ibc/8E27BA2D5493AF5636760E354E46004562C46AB7EC0CC4C1CA14E9E20E2545B5',
+        amount: '1000000',
+      },
+      sender: zoguxWallet.address,
+      receiver: nobleWallet.address,
+      timeoutTimestamp: Long.fromNumber(Math.floor(Date.now() / 1000) * 1e9 + 10 * 60 * 1e9),
+    },
+  };
+
+  const msgs = [ibcToNobleMsg];
+  const encodeObjects: Promise<EncodeObject[]> = new Promise((resolve) => resolve(msgs));
+
+  await zoguxClient.post.send(
+    SubaccountInfo.forLocalWallet(zoguxWallet),
+    () => {
+      return encodeObjects;
+    },
+    false,
+    undefined,
+    undefined,
+  );
+
+  await sleep(30000);
+
+  try {
+    const coins = await client.getAccountBalances();
+    console.log('Balances');
+    console.log(JSON.stringify(coins));
+
+    // IBC from noble
+
+    const ibcFromNobleMsg: EncodeObject = {
+      typeUrl: '/ibc.applications.transfer.v1.MsgTransfer',
+      value: {
+        sourcePort: 'transfer',
+        sourceChannel: 'channel-21',
+        token: {
+          denom: 'uusdc',
+          amount: coins[0].amount,
+        },
+        sender: nobleWallet.address,
+        receiver: zoguxWallet.address,
+        timeoutTimestamp: Long.fromNumber(Math.floor(Date.now() / 1000) * 1e9 + 10 * 60 * 1e9),
+      },
+    };
+    const fee = await client.simulateTransaction([ibcFromNobleMsg]);
+
+    ibcFromNobleMsg.value.token.amount = (
+      parseInt(ibcFromNobleMsg.value.token.amount, 10) -
+      Math.floor(parseInt(fee.amount[0].amount, 10) * 1.4)
+    ).toString();
+
+    await client.send([ibcFromNobleMsg]);
+  } catch (error) {
+    console.log(JSON.stringify(error.message));
+  }
+
+  await sleep(30000);
+
+  try {
+    const coin = await client.getAccountBalance('uusdc');
+    console.log('Balance');
+    console.log(JSON.stringify(coin));
+  } catch (error) {
+    console.log(JSON.stringify(error.message));
+  }
+}
+
+test()
+  .then(() => {})
+  .catch((error) => {
+    console.log(error.message);
+    console.log(error);
+  });

package/examples/optimal_node.ts

@@ -0,0 +1,70 @@
+import { TESTNET_CHAIN_ID } from '../src/clients/constants';
+import { NetworkOptimizer } from '../src/network_optimizer';
+
+async function testNodes(): Promise<void> {
+  // all valid endpoints
+  try {
+    const optimizer = new NetworkOptimizer();
+    const endpoints = [
+      'https://validator.v4testnet1.zogux.exchange',
+      'https://zogux-testnet.nodefleet.org',
+      'https://zogux-testnet-archive.allthatnode.com:26657/XZvMM41hESf8PJrEQiTzbCOMVyFca79R',
+    ];
+    const optimal = await optimizer.findOptimalNode(endpoints, TESTNET_CHAIN_ID);
+    console.log(optimal);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // one invalid endpoint
+  try {
+    const optimizer = new NetworkOptimizer();
+    const endpoints = [
+      'https://validator.v4testnet1.zogux.exchange',
+      'https://zogux-testnet.nodefleet.org',
+      'https://zogux-testnet-archive.allthatnode.com:26657/XZvMM41hESf8PJrEQiTzbCOMVyFca79R',
+      'https://example.com',
+    ];
+    const optimal = await optimizer.findOptimalNode(endpoints, TESTNET_CHAIN_ID);
+    console.log(optimal);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // all invalid endpoints
+
+  try {
+    const optimizer = new NetworkOptimizer();
+    const endpoints = ['https://example.com', 'https://example.org'];
+    const optimal = await optimizer.findOptimalNode(endpoints, TESTNET_CHAIN_ID);
+    console.log(optimal);
+  } catch (error) {
+    console.log(error.message);
+  }
+}
+
+async function testIndexers(): Promise<void> {
+  // all valid endpoints
+  try {
+    const optimizer = new NetworkOptimizer();
+    const endpoints = ['https://indexer.v4testnet2.zogux.exchange'];
+    const optimal = await optimizer.findOptimalIndexer(endpoints);
+    console.log(optimal);
+  } catch (error) {
+    console.log(error.message);
+  }
+
+  // all invalid endpoints
+
+  try {
+    const optimizer = new NetworkOptimizer();
+    const endpoints = ['https://example.com', 'https://example.org'];
+    const optimal = await optimizer.findOptimalIndexer(endpoints);
+    console.log(optimal);
+  } catch (error) {
+    console.log(error.message);
+  }
+}
+
+testNodes().catch(console.log);
+testIndexers().catch(console.log);