Create and track participations

"use client";

import { useCoinList } from "@coinlist-co/react";
import { useEffect } from "react";

export function ParticipationExample() {
  const { coinlist, isReady } = useCoinList();

  useEffect(() => {
    if (!isReady) return;

    const run = async () => {
      // 1) List existing participations
      const existing = await coinlist.tokenSale.fetchParticipations();
      console.log("Existing participations", existing.length);

      // 2) Create a new participation
      const created = await coinlist.tokenSale.createParticipation({
        offerId: "{offer_id}",
        offerOptionId: "{offer_option_id}",
        chain: "{chain}",
        walletAddress: "{wallet_address}",
        amount: "1000.00",
        assetId: "{asset_id}",
        // Required: hash of the ERC-20 approval transaction you submit first
        approvalTransactionHash: "{approval_transaction_hash}",
      });

      console.log("Created participation", created.id, created.status);
    };

    void run().catch((error) => {
      console.error("Participation flow failed", error);
    });
  }, [coinlist, isReady]);

  return null;
}

export async function createParticipation(accessToken: string) {
  const response = await fetch("https://api.coinlist.co/v1/participations", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      offer_id: "{offer_id}",
      offer_option_id: "{offer_option_id}",
      chain: "{chain}",
      wallet_address: "{wallet_address}",
      amount: "1000.00",
      asset_id: "{asset_id}",
      // Required: hash of the ERC-20 approval transaction you submit first
      approval_transaction_hash: "{approval_transaction_hash}",
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message ?? "Failed to create participation");
  }

  return response.json();
}

{
  "object": "participation",
  "id": "{participation_id}",
  "offer_id": "{offer_id}",
  "offer_option_id": "{offer_option_id}",
  "status": "pending",
  "amount": "1000.00",
  "amount_string": "1,000.00",
  "chain": "{chain}",
  "asset": {
    "id": "{asset_id}",
    "code": "USDC",
    "name": "USD Coin",
    "fractional_digits": 6
  },
  "wallet_address": "{wallet_address}"
}