Place HIP-4 orders, cancel, and convert outcome tokens

const adapter = createHIP4Adapter({
  testnet: false,
  minOrderNotional: 10, // reject orders below $10 notional, even though the protocol allows $1
});

const result = await adapter.trading.placeOrder({
  marketId: "516",
  outcome: "#5160",
  side: "buy",
  type: "limit",
  price: "0.65",
  amount: "100",
});

if (!result.success) {
  console.error(result.error);
}

import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
import {
  createHIP4Adapter,
  getAgentApprovalTypedData,
  submitAgentApproval,
} from "@outcome.xyz/hip4";

// userAccount: the user's viem account; walletClient: a viem WalletClient for it
const adapter = createHIP4Adapter({ testnet: false });
await adapter.initialize();

// --- Authentication (agent key flow) ---
const agent = privateKeyToAccount(generatePrivateKey());
const nonce = Date.now(); // sign and submit with the same nonce
const typedData = getAgentApprovalTypedData(
  agent.address,
  "My App",
  nonce,
  true, // true = mainnet, matching testnet: false above
);
const sig = await walletClient.signTypedData({
  account: userAccount,
  domain: typedData.domain,
  types: typedData.types,
  primaryType: typedData.primaryType,
  message: typedData.message,
});
const approval = await submitAgentApproval(sig, agent.address, "My App", nonce, true);
if (!approval.success) {
  throw new Error(`Agent approval failed: ${approval.error}`);
}
await adapter.auth.initAuth(userAccount.address, agent);

// --- Place a limit buy order ---
const limitResult = await adapter.trading.placeOrder({
  marketId: "516",
  outcome: "#5160", // side 0 (e.g. "Yes")
  side: "buy",
  type: "limit",
  price: "0.65",
  amount: "100",
  timeInForce: "GTC",
  markPx: 0.65, // enables minimum-shares validation
});

if (limitResult.success) {
  console.log("Order status:", limitResult.status);
  // "filled" or "resting"
  if (limitResult.status === "filled") {
    console.log("Filled shares:", limitResult.shares);
  }
} else {
  console.error("Order failed:", limitResult.error);
}

// --- Place a market sell order ---
const marketResult = await adapter.trading.placeOrder({
  marketId: "516",
  outcome: "#5161", // side 1 (e.g. "No")
  side: "sell",
  type: "market",
  amount: "50",
});

// --- Limit buy with builder fee ---
const builderResult = await adapter.trading.placeOrder({
  marketId: "516",
  outcome: "#5160",
  side: "buy",
  type: "limit",
  price: "0.70",
  amount: "25",
  builderAddress: "0xYourBuilderAddress",
  builderFee: 100, // 0.1%
});

// --- Close a small residual position, skipping notional check ---
const closeResult = await adapter.trading.placeOrder({
  marketId: "516",
  outcome: "#5160",
  side: "sell",
  type: "limit",
  price: "0.60",
  amount: "1", // $0.60 notional, below the $1 minimum
  skipMinNotionalCheck: true,
});

const batch = await adapter.trading.placeOrders([
  { marketId: "516", outcome: "#5160", side: "buy", type: "limit", price: "0.60", amount: "10" },
  { marketId: "516", outcome: "#5160", side: "buy", type: "limit", price: "0.58", amount: "10" },
]);

batch.success; // true only when every order succeeded
batch.results; // one PredictionOrderResult per input, in input order

const result = await adapter.trading.modifyOrder({
  marketId: "516",
  outcome: "#5160",
  orderId: "12345",
  side: "buy",
  type: "limit",
  price: "0.62",
  amount: "100",
});

await adapter.trading.cancelOrder([
  { marketId: "516", orderId: "12345", outcome: "#5160" },
]);

import { parseSideCoin } from "@outcome.xyz/hip4";

// Cancel a single resting order
const res = await adapter.trading.cancelOrder([
  { marketId: "516", orderId: "12345", outcome: "#5160" },
]);
console.log(res.response?.data.statuses); // e.g. ["success"]

// Cancel multiple orders at once
await adapter.trading.cancelOrder([
  { marketId: "516", orderId: "12345", outcome: "#5160" },
  { marketId: "516", orderId: "67890", outcome: "#5161" },
]);

// Fetch open orders first, then cancel the HIP-4 ones
const openOrders = await adapter.account.fetchOpenOrders(userAddress);
const cancels = openOrders.flatMap((order) => {
  const parsed = parseSideCoin(order.coin); // null for non-HIP-4 coins
  return parsed
    ? [{ marketId: String(parsed.outcomeId), orderId: String(order.oid), outcome: order.coin }]
    : [];
});
if (cancels.length > 0) {
  await adapter.trading.cancelOrder(cancels);
}

type WalletActionResult = {
  success: boolean;
  error?: string;
  filledSz?: string;
  avgPx?: string;
  oid?: number;
};

await adapter.trading.splitOutcome({
  outcome: 516,
  amount: "100",
});

await adapter.trading.mergeOutcome({
  outcome: 516,
  amount: "100",
});

// Or burn the max available:
await adapter.trading.mergeOutcome({ outcome: 516, amount: null });

await adapter.trading.mergeQuestion({
  question: 42,
  amount: "10",
});

// Or redeem the max available:
await adapter.trading.mergeQuestion({ question: 42, amount: null });

await adapter.trading.negateOutcome({
  question: 42,
  outcome: 516,
  amount: "5",
});