CosmES SDK

Under development

This section of the documentation is still under development. If you experience issues with the mentioned steps, please open an issue on the GitHub repository or submit a Pull Request with a fix.

CosmES is a modern, tree-shakeable, pure-ESM SDK for Cosmos SDK chains. Use the @goblinhunt/cosmesCopy @goblinhunt/cosmesCopied fork for Terra Classic projects.

Network endpoints

Tip PublicNode endpoints are suitable for development. For production workloads, operate your own infrastructure or purchase private access. Binodes provides backup endpoints at https://api-lunc-rpc.binodes.comCopy https://api-lunc-rpc.binodes.comCopied (RPC).

Wallets

• Galaxy Station (Hexxagon)
• Keplr
• Orbitar
• Cosmostation
• LUNC Dash mobile

CosmES includes controllers for Station, Keplr, Galaxy Station, LUNC Dash, Cosmostation, and a programmatic MnemonicWalletCopy MnemonicWalletCopied.

TS
import { KeplrController, WalletType } from "@goblinhunt/cosmes/wallet";

const controller = new KeplrController("<YOUR_WC_PROJECT_ID>");
const wallets = await controller.connect(WalletType.EXTENSION, [
  {
    chainId: "columbus-5",
    rpc: "https://terra-classic-rpc.publicnode.com",
    gasPrice: { denom: "uluna", amount: "28.325" },
  },
]);
const connected = wallets.get("columbus-5");
Copy

Install the SDK

BASH
yarn add @goblinhunt/cosmes
Copy

For TypeScript projects, enable modern module resolution:

JSON
{
  "compilerOptions": {
    "moduleResolution": "bundler"
  }
}
Copy

If you use Vite, define globalCopy globalCopied for WalletConnect v1 compatibility (remove when no longer required):

TS
// vite.config.ts
import { defineConfig } from "vite";

export default defineConfig({
  define: { global: "window" },
});
Copy

When connecting Station through WalletConnect v1, polyfill BufferCopy BufferCopied:

TS
// polyfill.ts
import { Buffer } from "buffer";

(window as unknown as { Buffer: typeof Buffer }).Buffer = Buffer;
Copy

Import the polyfill before bootstrapping your app.

Quick start

TS
import { getNativeBalances } from "@goblinhunt/cosmes/client";

const RPC = "https://terra-classic-rpc.publicnode.com"; // Prefer a private endpoint for production

async function main(): Promise<void> {
  const address = "terra1...";
  const balances = await getNativeBalances(RPC, { address });
  console.log(balances);
}

main().catch(console.error);
Copy

Send tokens example

TS
import { MsgSend } from "@goblinhunt/cosmes/client";
import { KeplrController, WalletType } from "@goblinhunt/cosmes/wallet";

const CHAIN_ID = "columbus-5";
const RPC = "https://terra-classic-rpc.publicnode.com";

async function sendExample(): Promise<void> {
  const controller = new KeplrController("<YOUR_WC_PROJECT_ID>");
  const wallets = await controller.connect(WalletType.EXTENSION, [
    { chainId: CHAIN_ID, rpc: RPC, gasPrice: { denom: "uluna", amount: "0.015" } },
  ]);
  const connected = wallets.get(CHAIN_ID);
  if (!connected) {
    throw new Error("Failed to connect wallet");
  }

  const msg = new MsgSend({
    fromAddress: connected.address,
    toAddress: "terra1...",
    amount: [{ denom: "uluna", amount: "100000" }],
  });

  const unsigned = { msgs: [msg], memo: "hello from CosmES" };
  const fee = await connected.estimateFee(unsigned, 1.2);
  const txHash = await connected.broadcastTx(unsigned, fee);
  console.log("txhash", txHash);
}

sendExample().catch(console.error);
Copy

Notes

• Use simulateTxCopy simulateTxCopied before broadcasting to confirm gas usage.
• Classic burn/tax behaviour is governed via proposals. Confirm current policy (e.g., Tax2Gas) before assuming on-chain deductions.