Token Sell

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

API Reference

sell

Sells tokens to the memejob protocol.

async sell(params: MJSellConfig): Promise<MJSellResult>

Arguments

interface MJSellConfig {
  /** Amount of tokens to sell (in smallest unit) */
  amount: bigint;
  /** Whether to execute the sell instantly */
  instant?: boolean;
  /** Optional referrer address for rewards */
  referrer?: string;
}

ReturnType

interface MJSellResult {
  /** Status of the transaction receipt */
  status: string;
  /** Hedera transaction id for NativeAdapter and Hash for EVMAdapter  */
  transactionIdOrHash: string;
  /** Amount of tokens sold (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");

// Sell 1_000_000 tokens with instant execution
const result = await token.sell({
  amount: 100000000000000n,
  instant: true,
});

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.sell({
  amount: 100000000000000n,
  instant: true
}); // <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. Instant Sells: Use instant: true for immediate sell execution
3. Balance Check: Verify sufficient token balance before selling
4. Gas Estimation: Consider gas costs when selling tokens

Error Handling

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

  const result = await token.sell({
    amount: 1000000000n,
    instant: true,
  });
} catch (error) {
  console.error("Sell operation failed:", error.message);
}