Token Buy

This guide explains how to buy tokens using the memejob SDK.

API Reference

buy

Buys tokens from the memejob protocol.

async buy(params: MJBuyConfig): Promise<MJBuyResult>

Arguments

interface MJBuyConfig {
  /** Amount of tokens to buy (in smallest unit) */
  amount: bigint;
  /** Optional referrer address for rewards */
  referrer?: string;
  /** Optional auto associate flag */
  autoAssociate?: boolean;
}

ReturnType

interface MJBuyResult {
  /** Status of the transaction receipt */
  status: string;
  /** Hedera transaction id for NativeAdapter and Hash for EVMAdapter  */
  transactionIdOrHash: string;
  /** Amount of tokens bought (in smallest unit) */
  amount: bigint;
}

Usage

import { ContractId } from "@hashgraph/sdk";
import { privateKeyToAccount } from "viem/accounts";
import {
  CONTRACT_DEPLOYMENTS,
  createAdapter,
  EvmAdapter,
  getChain,
  MJClient,
} from "@buidlerlabs/memejob-sdk-js";

const contractId = ContractId.fromEvmAddress(
  0,
  0,
  CONTRACT_DEPLOYMENTS.mainnet.evmAddress
);

// Initialize client
const client = new MJClient(
  createAdapter(EvmAdapter, {
    account: privateKeyToAccount("0x123..."),
  }),
  {
    chain: getChain("mainnet"),
    contractId,
  }
);

// Get token instance
const token = await client.getToken("0.0.5622410");

// Buy 1_000_000 tokens with referrer
const result = await token.buy({
  amount: 100000000000000n,
  referrer: "0x000...000",
});

When operationalMode is set to returnBytes, the final result will be the transaction’s byte array:

const client = new MJClient(
 createAdapter(NativeAdapter, {
    operator: {
      accountId: AccountId.fromString("0.0.123456"),
      privateKey: PrivateKey.fromStringECDSA("<private-key>"),
    },
    operationalMode: "returnBytes"
  }),
  {
    chain: getChain("mainnet"),
    contractId
  }
);

...

const token = await client.getToken("0.0.5622410");

const transactionBytes = await token.buy({
  amount: 100000000000000n,
  referrer: "0x000...000",
}); // <Buffer 0a 85 01 1a ... and more bytes>

WARNING

The operationalMode config is supported only by the NativeAdapter.

Best Practices

1. Amount Precision: Always use bigint for token amounts to avoid precision issues
2. Referrers: Include referrer addresses to enable reward distribution
3. Error Handling: Always implement proper error handling for transactions
4. Balance Check: Verify sufficient HBAR balance before buying

Error Handling

try {
  const token = await client.getToken("0.0.5622410");

  const result = await token.buy({
    amount: 100000000000000n,
  });
} catch (error) {
  console.error("Buy operation failed:", error.message);
}