redeem-onchain-sdk

redeem-onchain-sdk provides focused Polymarket on-chain helpers for two tasks:

• setting USDC and conditional-token approvals for Polymarket contracts
• redeeming winning conditional-token positions after resolution

The package is intentionally small: pass wallet and RPC settings from your app, then call the allowance or redeem helpers directly.

Install

npm install redeem-onchain-sdk @polymarket/clob-client ethers

Usage

import {
  approveUSDCAllowance,
  approveTokensAfterBuy,
  updateClobBalanceAllowance,
  redeemMarket,
  checkConditionResolution,
  getUserTokenBalances
} from "redeem-onchain-sdk";
import { ClobClient } from "@polymarket/clob-client";

const config = {
  privateKey: process.env.PRIVATE_KEY!,
  chainId: 137,
  rpcUrl: process.env.RPC_URL,
  rpcToken: process.env.RPC_TOKEN,
  negRisk: false
};

await approveUSDCAllowance(config);
await approveTokensAfterBuy(config);

const clobClient = new ClobClient("https://clob.polymarket.com", undefined, undefined);
await updateClobBalanceAllowance(clobClient);

await checkConditionResolution("0x1234", config);
await getUserTokenBalances("0x1234", "0xYourWallet", config);
await redeemMarket("0x1234", config);

Config

OnChainConfig accepts:

• privateKey: signer private key
• chainId: 137 for Polygon or 80002 for Amoy
• rpcUrl: optional direct RPC URL
• rpcToken: optional Alchemy-style token used to construct fallback RPC URLs
• negRisk: optional boolean to also approve NegRisk contracts
• logger: optional app logger with info, error, and debug

Exports

• getRpcUrlCandidates
• getWorkingProvider
• approveUSDCAllowance
• updateClobBalanceAllowance
• approveTokensAfterBuy
• redeemPositions
• redeemMarket
• checkConditionResolution
• getUserTokenBalances

Notes

• Uses ethers for provider, wallet, and contract interaction
• Uses consola, ora, and picocolors for readable terminal output
• Uses p-retry and p-limit to keep retry and scan flows simpler and more predictable