fix(poidh): add all V3 custom errors to ABI + human-readable error messages

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: sktbrd

src/hooks/usePoidhContract.ts

@@ -69,6 +69,44 @@ function buildPoidhReturn(state: PoidhWriteState) {
   };
 }
 
+const POIDH_ERROR_MESSAGES: Record<string, string> = {
+  AlreadyVoted:                  "You have already voted on this claim.",
+  ClaimNotFound:                 "Claim not found on-chain. Make sure you're on the right network.",
+  BountyNotFound:                "Bounty not found on-chain.",
+  VotingOngoing:                 "Voting is still in progress — wait for the deadline to resolve.",
+  VotingEnded:                   "The voting period has ended.",
+  NoVotingPeriodSet:             "No voting period is active for this bounty.",
+  BountyClaimed:                 "This bounty has already been claimed.",
+  BountyClosed:                  "This bounty is closed.",
+  WrongCaller:                   "You are not allowed to perform this action.",
+  IssuerCannotClaim:             "The bounty creator cannot submit a claim.",
+  IssuerCannotWithdraw:          "The bounty creator cannot withdraw as a contributor.",
+  NotActiveParticipant:          "You are not a participant in this bounty.",
+  NotOpenBounty:                 "This action is only available for open bounties.",
+  NotSoloBounty:                 "This action is only available for solo bounties.",
+  ClaimAlreadyAccepted:          "This claim has already been accepted.",
+  NothingToWithdraw:             "Nothing to withdraw.",
+  MaxParticipantsReached:        "This bounty has reached its maximum number of participants.",
+  NotCancelledOpenBounty:        "This bounty has not been cancelled.",
+  VoteWouldPass:                 "Cannot reset — the vote would pass. Resolve it instead.",
+  MinimumBountyNotMet:           "Amount is below the minimum required to create a bounty.",
+  MinimumContributionNotMet:     "Amount is below the minimum required to contribute.",
+  NoEther:                       "No ETH sent.",
+  ContractsCannotCreateBounties: "Smart contracts cannot create bounties directly.",
+  TransferFailed:                "ETH transfer failed.",
+  InsufficientBalance:           "Insufficient balance.",
+};
+
+function decodePoidhError(err: unknown): Error {
+  if (!(err instanceof Error)) return new Error(String(err));
+  const msg = err.message;
+  for (const [name, friendly] of Object.entries(POIDH_ERROR_MESSAGES)) {
+    if (msg.includes(name)) return new Error(friendly);
+  }
+  // Fallback: trim the noisy viem stack to the first line
+  return new Error(msg.split("\n")[0]);
+}
+
 async function assertPoidhReady(ctx: ReturnType<typeof usePoidhContext>, chainId: number) {
   if (!ctx.isConnected) throw new Error("Connect your wallet first");
   if (!ctx.contractAddress) throw new Error(`Unsupported chain: ${chainId}`);
@@ -113,7 +151,7 @@ async function sendAndConfirm(
     state.setIsSuccess(true);
     return txHash;
   } catch (err) {
-    state.setError(err instanceof Error ? err : new Error(String(err)));
+    state.setError(decodePoidhError(err));
     throw err;
   } finally {
     state.setIsPending(false);

src/lib/poidh/abi.ts

@@ -182,5 +182,38 @@ export const POIDH_ABI = [
     "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }],
     "stateMutability": "view",
     "type": "function"
-  }
+  },
+  // ── Custom errors ────────────────────────────────────────────────────────
+  { "inputs": [], "name": "NoEther",                       "type": "error" },
+  { "inputs": [], "name": "MinimumBountyNotMet",           "type": "error" },
+  { "inputs": [], "name": "MinimumContributionNotMet",     "type": "error" },
+  { "inputs": [], "name": "BountyNotFound",                "type": "error" },
+  { "inputs": [], "name": "ClaimNotFound",                 "type": "error" },
+  { "inputs": [], "name": "VotingOngoing",                 "type": "error" },
+  { "inputs": [], "name": "VotingEnded",                   "type": "error" },
+  { "inputs": [], "name": "NoVotingPeriodSet",             "type": "error" },
+  { "inputs": [], "name": "BountyClaimed",                 "type": "error" },
+  { "inputs": [], "name": "BountyClosed",                  "type": "error" },
+  { "inputs": [], "name": "NotOpenBounty",                 "type": "error" },
+  { "inputs": [], "name": "NotSoloBounty",                 "type": "error" },
+  { "inputs": [], "name": "WrongCaller",                   "type": "error" },
+  { "inputs": [], "name": "IssuerCannotClaim",             "type": "error" },
+  { "inputs": [], "name": "IssuerCannotWithdraw",          "type": "error" },
+  { "inputs": [], "name": "NotActiveParticipant",          "type": "error" },
+  { "inputs": [], "name": "AlreadyVoted",                  "type": "error" },
+  { "inputs": [], "name": "ClaimAlreadyAccepted",          "type": "error" },
+  { "inputs": [], "name": "NothingToWithdraw",             "type": "error" },
+  { "inputs": [], "name": "TransferFailed",                "type": "error" },
+  { "inputs": [], "name": "InsufficientBalance",           "type": "error" },
+  { "inputs": [], "name": "MaxParticipantsReached",        "type": "error" },
+  { "inputs": [], "name": "NotCancelledOpenBounty",        "type": "error" },
+  { "inputs": [], "name": "VoteWouldPass",                 "type": "error" },
+  { "inputs": [], "name": "InvalidStartClaimIndex",        "type": "error" },
+  { "inputs": [], "name": "ContractsCannotCreateBounties", "type": "error" },
+  { "inputs": [], "name": "InvalidTreasury",               "type": "error" },
+  { "inputs": [], "name": "InvalidPoidhNft",               "type": "error" },
+  { "inputs": [], "name": "InvalidWithdrawTo",             "type": "error" },
+  { "inputs": [], "name": "DirectEtherNotAccepted",        "type": "error" },
+  { "inputs": [], "name": "InvalidMinBountyAmount",        "type": "error" },
+  { "inputs": [], "name": "InvalidMinContribution",        "type": "error" }
 ] as const;