@puul/partner-sdk 1.0.0 → 1.2.0

package/README.md

@@ -139,8 +139,20 @@ await puul.wallet.deposit({
   currency: 'USDC',
   idempotency_key: 'dep_unique_123',
 });
+
+// Withdraw from omnibus to configured bank/crypto destination
+const withdrawal = await puul.wallet.withdraw({
+  amount: 500000,       // $5,000 in minor units
+  currency: 'USDC',
+  method: 'bank',       // or 'crypto'
+});
+// withdrawal.withdrawalId, withdrawal.status
 ```
 
+> **Auto-Settlement:** If your `payout_method` is configured (via the admin dashboard),
+> revenue share is automatically paid out after each market settlement. You don't need
+> to call `withdraw()` manually — it happens at settlement time.
+
 ### Webhook Verification
 
 ```typescript
@@ -163,9 +175,16 @@ app.post('/webhooks/puul', express.raw({ type: '*/*' }), (req, res) => {
     case 'prediction.settled':
       console.log('Prediction settled:', event.data);
       break;
+    case 'prediction.voided':
+      console.log('Prediction voided:', event.data);
+      // Handle refund — user gets full stake back
+      break;
     case 'deposit.confirmed':
       console.log('Deposit confirmed:', event.data);
       break;
+    case 'withdrawal.completed':
+      console.log('Withdrawal completed:', event.data);
+      break;
   }
 
   res.status(200).send('OK');

package/dist/index.d.mts

@@ -33,22 +33,27 @@ interface MarketOutcome {
     id: string;
     slug: string;
     label: string;
-    pool: {
-        pool_amount: string;
-        total_bets: number;
-    };
+    display_order: number;
+    pool_amount: string;
+    predictor_count: number;
+    prediction_count: number;
 }
 interface Market {
     id: string;
     question: string;
-    description: string;
     category: string;
+    image_url: string;
+    market_type: string;
     status: string;
     currency: string;
     close_time: string;
     freeze_at: string | null;
-    target_countries: string[];
     outcomes: MarketOutcome[];
+    volume: number;
+    volume_currency: string;
+    predictor_count: number;
+    prediction_count: number;
+    created_at: string;
 }
 type PredictionStatus = 'OPEN' | 'WON' | 'LOST' | 'VOIDED';
 type Currency = 'NGN' | 'USDC' | 'USDT' | 'KES' | 'GHS' | 'ZAR';
@@ -149,26 +154,136 @@ interface DepositParams {
     idempotency_key: string;
     reference?: string;
 }
-type WebhookEventType = 'prediction.settled' | 'deposit.confirmed' | 'withdrawal.completed';
-interface WebhookEvent<T = {
-    [key: string]: unknown;
-}> {
+type WithdrawMethod = 'bank' | 'crypto';
+interface WithdrawParams {
+    /** Amount to withdraw in minor units (cents) */
+    amount: number;
+    /** Currency to withdraw. Defaults to USDC */
+    currency?: Currency;
+    /** Payout method: 'bank' for fiat, 'crypto' for on-chain */
+    method?: WithdrawMethod;
+}
+interface WithdrawResult {
+    withdrawalId: string;
+    partnerId: string;
+    amount: number;
+    currency: string;
+    method: WithdrawMethod;
+    payoutReference: string | null;
+    status: string;
+}
+type WebhookEventType = 'user.created' | 'prediction.placed' | 'prediction.settled' | 'prediction.voided' | 'market.closed' | 'market.settled' | 'deposit.confirmed' | 'withdrawal.completed' | 'withdrawal.failed';
+interface WebhookEvent<T = unknown> {
     event: WebhookEventType;
     timestamp: string;
     data: T;
 }
-interface PredictionSettledData {
+interface UserCreatedData {
+    puul_user_id: string;
+    external_user_id: string;
+    email: string;
+    phone: string;
+    country_code: string;
+    created_at: string;
+}
+interface PredictionPlacedData {
     prediction_id: string;
+    user_id: string;
+    user_external_id: string;
     market_id: string;
+    market_question: string;
     outcome_id: string;
     outcome_slug: string;
+    outcome_label: string;
+    stake_amount: number;
+    stake_currency: string;
+    estimated_return: string;
+    idempotency_key: string;
+    placed_at: string;
+}
+interface PredictionSettledData {
+    prediction_id: string;
+    user_id: string;
     user_external_id: string;
-    status: 'WON' | 'LOST' | 'VOIDED';
+    market_id: string;
+    market_question: string;
+    outcome_id: string;
+    outcome_slug: string;
+    outcome_label: string;
+    stake_amount: string;
+    stake_currency: string;
+    status: 'WON' | 'LOST';
+    payout: string;
+    multiplier: string;
+    settled_at: string;
+}
+interface PredictionVoidedData {
+    prediction_id: string;
+    user_id: string;
+    user_external_id: string | null;
+    market_id: string;
+    market_question: string | null;
+    outcome_label: string | null;
     stake_amount: string;
     stake_currency: string;
-    final_return: string;
+    refund_amount: string;
+    voided_at: string;
+    reason: string;
+}
+interface MarketClosedData {
+    market_id: string;
+    market_question: string;
+    market_type: string;
+    close_time: string;
+    closed_at: string;
+    currency: string;
+    volume: number;
+    prediction_count: number;
+}
+interface MarketSettledData {
+    market_id: string;
+    market_question: string;
+    market_type: string;
+    winning_outcome_id: string;
+    winning_outcome_slug: string | null;
+    winning_outcome_label: string | null;
+    currency: string;
+    total_pool: number;
+    winners_count: number;
+    total_payout: number;
     settled_at: string;
 }
+interface DepositConfirmedData {
+    deposit_id: string;
+    user_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    amount_usd: number;
+    tx_hash: string;
+    status: string;
+    confirmed_at: string;
+}
+interface WithdrawalCompletedData {
+    withdrawal_id: string;
+    partner_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    method: string;
+    payout_reference: string | null;
+    completed_at: string;
+}
+interface WithdrawalFailedData {
+    withdrawal_id: string;
+    partner_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    method: string;
+    reason: string;
+    failed_at: string;
+}
 interface PuulApiError {
     statusCode: number;
     message: string | string[];
@@ -274,6 +389,20 @@ declare class WalletAPI {
     deposit(params: DepositParams): Promise<unknown>;
     /** Get withdrawal fee estimate */
     getWithdrawalFees(currency: string, amount: number): Promise<unknown>;
+    /**
+     * Withdraw from omnibus balance.
+     * Initiates a payout to the partner's configured bank account or crypto wallet.
+     *
+     * @example
+     * ```typescript
+     * const result = await puul.wallet.withdraw({
+     *   amount: 500000, // $5,000 in cents
+     *   currency: 'USDC',
+     *   method: 'bank', // or 'crypto'
+     * });
+     * ```
+     */
+    withdraw(params: WithdrawParams): Promise<WithdrawResult>;
 }
 
 /**
@@ -318,22 +447,37 @@ declare function verifyWebhookSignature(payload: string, signature: string, secr
  * const event = parseWebhookEvent(req.body);
  *
  * if (event.event === 'prediction.settled') {
- *   const { prediction_id, status, final_return } = event.data;
+ *   const { prediction_id, status, payout } = event.data;
  *   // Handle settlement...
  * }
  * ```
  */
 declare function parseWebhookEvent(body: unknown): WebhookEvent;
-/**
- * Type guard for prediction.settled events.
- * Returns true if the event type is 'prediction.settled'.
- * Use this to narrow the type before accessing `.data` as PredictionSettledData.
- */
-declare function isPredictionSettledEvent(event: WebhookEvent): boolean;
+/** Type guard for prediction.placed events. */
+declare function isPredictionPlacedEvent(event: WebhookEvent): event is WebhookEvent<PredictionPlacedData>;
+/** Type guard for prediction.settled events. */
+declare function isPredictionSettledEvent(event: WebhookEvent): event is WebhookEvent<PredictionSettledData>;
+/** Type guard for prediction.voided events. */
+declare function isPredictionVoidedEvent(event: WebhookEvent): event is WebhookEvent<PredictionVoidedData>;
+/** Type guard for market.closed events. */
+declare function isMarketClosedEvent(event: WebhookEvent): event is WebhookEvent<MarketClosedData>;
+/** Type guard for market.settled events. */
+declare function isMarketSettledEvent(event: WebhookEvent): event is WebhookEvent<MarketSettledData>;
+/** Type guard for deposit.confirmed events. */
+declare function isDepositConfirmedEvent(event: WebhookEvent): event is WebhookEvent<DepositConfirmedData>;
+/** Type guard for withdrawal.completed events. */
+declare function isWithdrawalCompletedEvent(event: WebhookEvent): event is WebhookEvent<WithdrawalCompletedData>;
+/** Type guard for withdrawal.failed events. */
+declare function isWithdrawalFailedEvent(event: WebhookEvent): event is WebhookEvent<WithdrawalFailedData>;
 /**
  * Convenience cast for prediction.settled event data.
  * Call after verifying with `isPredictionSettledEvent`.
  */
 declare function asPredictionSettledData(event: WebhookEvent): PredictionSettledData;
+/**
+ * Convenience cast for market.settled event data.
+ * Call after verifying with `isMarketSettledEvent`.
+ */
+declare function asMarketSettledData(event: WebhookEvent): MarketSettledData;
 
-export { type AccessTokenResponse, type CreateLinkTokenParams, type CreatePendingPredictionParams, type CreateQuoteParams, type Currency, type DepositAccountInfo, type DepositParams, type LinkTokenResponse, type Market, type MarketOutcome, type PendingPrediction, type PlacePredictionParams, type Prediction, type PredictionListResponse, type PredictionSettledData, type PredictionStatus, type PuulApiError, PuulError, PuulPartner, type PuulPartnerConfig, type QuoteResponse, type SessionResponse, type WalletBalance, type WebhookEvent, type WebhookEventType, asPredictionSettledData, isPredictionSettledEvent, parseWebhookEvent, verifyWebhookSignature };
+export { type AccessTokenResponse, type CreateLinkTokenParams, type CreatePendingPredictionParams, type CreateQuoteParams, type Currency, type DepositAccountInfo, type DepositConfirmedData, type DepositParams, type LinkTokenResponse, type Market, type MarketClosedData, type MarketOutcome, type MarketSettledData, type PendingPrediction, type PlacePredictionParams, type Prediction, type PredictionListResponse, type PredictionPlacedData, type PredictionSettledData, type PredictionStatus, type PredictionVoidedData, type PuulApiError, PuulError, PuulPartner, type PuulPartnerConfig, type QuoteResponse, type SessionResponse, type UserCreatedData, type WalletBalance, type WebhookEvent, type WebhookEventType, type WithdrawMethod, type WithdrawParams, type WithdrawResult, type WithdrawalCompletedData, type WithdrawalFailedData, asMarketSettledData, asPredictionSettledData, isDepositConfirmedEvent, isMarketClosedEvent, isMarketSettledEvent, isPredictionPlacedEvent, isPredictionSettledEvent, isPredictionVoidedEvent, isWithdrawalCompletedEvent, isWithdrawalFailedEvent, parseWebhookEvent, verifyWebhookSignature };

package/dist/index.d.ts

@@ -33,22 +33,27 @@ interface MarketOutcome {
     id: string;
     slug: string;
     label: string;
-    pool: {
-        pool_amount: string;
-        total_bets: number;
-    };
+    display_order: number;
+    pool_amount: string;
+    predictor_count: number;
+    prediction_count: number;
 }
 interface Market {
     id: string;
     question: string;
-    description: string;
     category: string;
+    image_url: string;
+    market_type: string;
     status: string;
     currency: string;
     close_time: string;
     freeze_at: string | null;
-    target_countries: string[];
     outcomes: MarketOutcome[];
+    volume: number;
+    volume_currency: string;
+    predictor_count: number;
+    prediction_count: number;
+    created_at: string;
 }
 type PredictionStatus = 'OPEN' | 'WON' | 'LOST' | 'VOIDED';
 type Currency = 'NGN' | 'USDC' | 'USDT' | 'KES' | 'GHS' | 'ZAR';
@@ -149,26 +154,136 @@ interface DepositParams {
     idempotency_key: string;
     reference?: string;
 }
-type WebhookEventType = 'prediction.settled' | 'deposit.confirmed' | 'withdrawal.completed';
-interface WebhookEvent<T = {
-    [key: string]: unknown;
-}> {
+type WithdrawMethod = 'bank' | 'crypto';
+interface WithdrawParams {
+    /** Amount to withdraw in minor units (cents) */
+    amount: number;
+    /** Currency to withdraw. Defaults to USDC */
+    currency?: Currency;
+    /** Payout method: 'bank' for fiat, 'crypto' for on-chain */
+    method?: WithdrawMethod;
+}
+interface WithdrawResult {
+    withdrawalId: string;
+    partnerId: string;
+    amount: number;
+    currency: string;
+    method: WithdrawMethod;
+    payoutReference: string | null;
+    status: string;
+}
+type WebhookEventType = 'user.created' | 'prediction.placed' | 'prediction.settled' | 'prediction.voided' | 'market.closed' | 'market.settled' | 'deposit.confirmed' | 'withdrawal.completed' | 'withdrawal.failed';
+interface WebhookEvent<T = unknown> {
     event: WebhookEventType;
     timestamp: string;
     data: T;
 }
-interface PredictionSettledData {
+interface UserCreatedData {
+    puul_user_id: string;
+    external_user_id: string;
+    email: string;
+    phone: string;
+    country_code: string;
+    created_at: string;
+}
+interface PredictionPlacedData {
     prediction_id: string;
+    user_id: string;
+    user_external_id: string;
     market_id: string;
+    market_question: string;
     outcome_id: string;
     outcome_slug: string;
+    outcome_label: string;
+    stake_amount: number;
+    stake_currency: string;
+    estimated_return: string;
+    idempotency_key: string;
+    placed_at: string;
+}
+interface PredictionSettledData {
+    prediction_id: string;
+    user_id: string;
     user_external_id: string;
-    status: 'WON' | 'LOST' | 'VOIDED';
+    market_id: string;
+    market_question: string;
+    outcome_id: string;
+    outcome_slug: string;
+    outcome_label: string;
+    stake_amount: string;
+    stake_currency: string;
+    status: 'WON' | 'LOST';
+    payout: string;
+    multiplier: string;
+    settled_at: string;
+}
+interface PredictionVoidedData {
+    prediction_id: string;
+    user_id: string;
+    user_external_id: string | null;
+    market_id: string;
+    market_question: string | null;
+    outcome_label: string | null;
     stake_amount: string;
     stake_currency: string;
-    final_return: string;
+    refund_amount: string;
+    voided_at: string;
+    reason: string;
+}
+interface MarketClosedData {
+    market_id: string;
+    market_question: string;
+    market_type: string;
+    close_time: string;
+    closed_at: string;
+    currency: string;
+    volume: number;
+    prediction_count: number;
+}
+interface MarketSettledData {
+    market_id: string;
+    market_question: string;
+    market_type: string;
+    winning_outcome_id: string;
+    winning_outcome_slug: string | null;
+    winning_outcome_label: string | null;
+    currency: string;
+    total_pool: number;
+    winners_count: number;
+    total_payout: number;
     settled_at: string;
 }
+interface DepositConfirmedData {
+    deposit_id: string;
+    user_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    amount_usd: number;
+    tx_hash: string;
+    status: string;
+    confirmed_at: string;
+}
+interface WithdrawalCompletedData {
+    withdrawal_id: string;
+    partner_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    method: string;
+    payout_reference: string | null;
+    completed_at: string;
+}
+interface WithdrawalFailedData {
+    withdrawal_id: string;
+    partner_id: string;
+    external_user_id: string;
+    amount: number;
+    currency: string;
+    method: string;
+    reason: string;
+    failed_at: string;
+}
 interface PuulApiError {
     statusCode: number;
     message: string | string[];
@@ -274,6 +389,20 @@ declare class WalletAPI {
     deposit(params: DepositParams): Promise<unknown>;
     /** Get withdrawal fee estimate */
     getWithdrawalFees(currency: string, amount: number): Promise<unknown>;
+    /**
+     * Withdraw from omnibus balance.
+     * Initiates a payout to the partner's configured bank account or crypto wallet.
+     *
+     * @example
+     * ```typescript
+     * const result = await puul.wallet.withdraw({
+     *   amount: 500000, // $5,000 in cents
+     *   currency: 'USDC',
+     *   method: 'bank', // or 'crypto'
+     * });
+     * ```
+     */
+    withdraw(params: WithdrawParams): Promise<WithdrawResult>;
 }
 
 /**
@@ -318,22 +447,37 @@ declare function verifyWebhookSignature(payload: string, signature: string, secr
  * const event = parseWebhookEvent(req.body);
  *
  * if (event.event === 'prediction.settled') {
- *   const { prediction_id, status, final_return } = event.data;
+ *   const { prediction_id, status, payout } = event.data;
  *   // Handle settlement...
  * }
  * ```
  */
 declare function parseWebhookEvent(body: unknown): WebhookEvent;
-/**
- * Type guard for prediction.settled events.
- * Returns true if the event type is 'prediction.settled'.
- * Use this to narrow the type before accessing `.data` as PredictionSettledData.
- */
-declare function isPredictionSettledEvent(event: WebhookEvent): boolean;
+/** Type guard for prediction.placed events. */
+declare function isPredictionPlacedEvent(event: WebhookEvent): event is WebhookEvent<PredictionPlacedData>;
+/** Type guard for prediction.settled events. */
+declare function isPredictionSettledEvent(event: WebhookEvent): event is WebhookEvent<PredictionSettledData>;
+/** Type guard for prediction.voided events. */
+declare function isPredictionVoidedEvent(event: WebhookEvent): event is WebhookEvent<PredictionVoidedData>;
+/** Type guard for market.closed events. */
+declare function isMarketClosedEvent(event: WebhookEvent): event is WebhookEvent<MarketClosedData>;
+/** Type guard for market.settled events. */
+declare function isMarketSettledEvent(event: WebhookEvent): event is WebhookEvent<MarketSettledData>;
+/** Type guard for deposit.confirmed events. */
+declare function isDepositConfirmedEvent(event: WebhookEvent): event is WebhookEvent<DepositConfirmedData>;
+/** Type guard for withdrawal.completed events. */
+declare function isWithdrawalCompletedEvent(event: WebhookEvent): event is WebhookEvent<WithdrawalCompletedData>;
+/** Type guard for withdrawal.failed events. */
+declare function isWithdrawalFailedEvent(event: WebhookEvent): event is WebhookEvent<WithdrawalFailedData>;
 /**
  * Convenience cast for prediction.settled event data.
  * Call after verifying with `isPredictionSettledEvent`.
  */
 declare function asPredictionSettledData(event: WebhookEvent): PredictionSettledData;
+/**
+ * Convenience cast for market.settled event data.
+ * Call after verifying with `isMarketSettledEvent`.
+ */
+declare function asMarketSettledData(event: WebhookEvent): MarketSettledData;
 
-export { type AccessTokenResponse, type CreateLinkTokenParams, type CreatePendingPredictionParams, type CreateQuoteParams, type Currency, type DepositAccountInfo, type DepositParams, type LinkTokenResponse, type Market, type MarketOutcome, type PendingPrediction, type PlacePredictionParams, type Prediction, type PredictionListResponse, type PredictionSettledData, type PredictionStatus, type PuulApiError, PuulError, PuulPartner, type PuulPartnerConfig, type QuoteResponse, type SessionResponse, type WalletBalance, type WebhookEvent, type WebhookEventType, asPredictionSettledData, isPredictionSettledEvent, parseWebhookEvent, verifyWebhookSignature };
+export { type AccessTokenResponse, type CreateLinkTokenParams, type CreatePendingPredictionParams, type CreateQuoteParams, type Currency, type DepositAccountInfo, type DepositConfirmedData, type DepositParams, type LinkTokenResponse, type Market, type MarketClosedData, type MarketOutcome, type MarketSettledData, type PendingPrediction, type PlacePredictionParams, type Prediction, type PredictionListResponse, type PredictionPlacedData, type PredictionSettledData, type PredictionStatus, type PredictionVoidedData, type PuulApiError, PuulError, PuulPartner, type PuulPartnerConfig, type QuoteResponse, type SessionResponse, type UserCreatedData, type WalletBalance, type WebhookEvent, type WebhookEventType, type WithdrawMethod, type WithdrawParams, type WithdrawResult, type WithdrawalCompletedData, type WithdrawalFailedData, asMarketSettledData, asPredictionSettledData, isDepositConfirmedEvent, isMarketClosedEvent, isMarketSettledEvent, isPredictionPlacedEvent, isPredictionSettledEvent, isPredictionVoidedEvent, isWithdrawalCompletedEvent, isWithdrawalFailedEvent, parseWebhookEvent, verifyWebhookSignature };

package/dist/index.js

@@ -22,8 +22,16 @@ var index_exports = {};
 __export(index_exports, {
   PuulError: () => PuulError,
   PuulPartner: () => PuulPartner,
+  asMarketSettledData: () => asMarketSettledData,
   asPredictionSettledData: () => asPredictionSettledData,
+  isDepositConfirmedEvent: () => isDepositConfirmedEvent,
+  isMarketClosedEvent: () => isMarketClosedEvent,
+  isMarketSettledEvent: () => isMarketSettledEvent,
+  isPredictionPlacedEvent: () => isPredictionPlacedEvent,
   isPredictionSettledEvent: () => isPredictionSettledEvent,
+  isPredictionVoidedEvent: () => isPredictionVoidedEvent,
+  isWithdrawalCompletedEvent: () => isWithdrawalCompletedEvent,
+  isWithdrawalFailedEvent: () => isWithdrawalFailedEvent,
   parseWebhookEvent: () => parseWebhookEvent,
   verifyWebhookSignature: () => verifyWebhookSignature
 });
@@ -229,6 +237,22 @@ var WalletAPI = class {
   async getWithdrawalFees(currency, amount) {
     return this.client.request("GET", `/partner/wallet/withdrawal-fees?currency=${currency}&amount=${amount}`);
   }
+  /**
+   * Withdraw from omnibus balance.
+   * Initiates a payout to the partner's configured bank account or crypto wallet.
+   *
+   * @example
+   * ```typescript
+   * const result = await puul.wallet.withdraw({
+   *   amount: 500000, // $5,000 in cents
+   *   currency: 'USDC',
+   *   method: 'bank', // or 'crypto'
+   * });
+   * ```
+   */
+  async withdraw(params) {
+    return this.client.request("POST", "/partner/wallet/withdraw", params);
+  }
 };
 
 // src/webhooks.ts
@@ -263,18 +287,50 @@ function parseWebhookEvent(body) {
     data: event.data || {}
   };
 }
+function isPredictionPlacedEvent(event) {
+  return event.event === "prediction.placed";
+}
 function isPredictionSettledEvent(event) {
   return event.event === "prediction.settled";
 }
+function isPredictionVoidedEvent(event) {
+  return event.event === "prediction.voided";
+}
+function isMarketClosedEvent(event) {
+  return event.event === "market.closed";
+}
+function isMarketSettledEvent(event) {
+  return event.event === "market.settled";
+}
+function isDepositConfirmedEvent(event) {
+  return event.event === "deposit.confirmed";
+}
+function isWithdrawalCompletedEvent(event) {
+  return event.event === "withdrawal.completed";
+}
+function isWithdrawalFailedEvent(event) {
+  return event.event === "withdrawal.failed";
+}
 function asPredictionSettledData(event) {
   return event.data;
 }
+function asMarketSettledData(event) {
+  return event.data;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PuulError,
   PuulPartner,
+  asMarketSettledData,
   asPredictionSettledData,
+  isDepositConfirmedEvent,
+  isMarketClosedEvent,
+  isMarketSettledEvent,
+  isPredictionPlacedEvent,
   isPredictionSettledEvent,
+  isPredictionVoidedEvent,
+  isWithdrawalCompletedEvent,
+  isWithdrawalFailedEvent,
   parseWebhookEvent,
   verifyWebhookSignature
 });

package/dist/index.mjs

@@ -198,6 +198,22 @@ var WalletAPI = class {
   async getWithdrawalFees(currency, amount) {
     return this.client.request("GET", `/partner/wallet/withdrawal-fees?currency=${currency}&amount=${amount}`);
   }
+  /**
+   * Withdraw from omnibus balance.
+   * Initiates a payout to the partner's configured bank account or crypto wallet.
+   *
+   * @example
+   * ```typescript
+   * const result = await puul.wallet.withdraw({
+   *   amount: 500000, // $5,000 in cents
+   *   currency: 'USDC',
+   *   method: 'bank', // or 'crypto'
+   * });
+   * ```
+   */
+  async withdraw(params) {
+    return this.client.request("POST", "/partner/wallet/withdraw", params);
+  }
 };
 
 // src/webhooks.ts
@@ -232,17 +248,49 @@ function parseWebhookEvent(body) {
     data: event.data || {}
   };
 }
+function isPredictionPlacedEvent(event) {
+  return event.event === "prediction.placed";
+}
 function isPredictionSettledEvent(event) {
   return event.event === "prediction.settled";
 }
+function isPredictionVoidedEvent(event) {
+  return event.event === "prediction.voided";
+}
+function isMarketClosedEvent(event) {
+  return event.event === "market.closed";
+}
+function isMarketSettledEvent(event) {
+  return event.event === "market.settled";
+}
+function isDepositConfirmedEvent(event) {
+  return event.event === "deposit.confirmed";
+}
+function isWithdrawalCompletedEvent(event) {
+  return event.event === "withdrawal.completed";
+}
+function isWithdrawalFailedEvent(event) {
+  return event.event === "withdrawal.failed";
+}
 function asPredictionSettledData(event) {
   return event.data;
 }
+function asMarketSettledData(event) {
+  return event.data;
+}
 export {
   PuulError,
   PuulPartner,
+  asMarketSettledData,
   asPredictionSettledData,
+  isDepositConfirmedEvent,
+  isMarketClosedEvent,
+  isMarketSettledEvent,
+  isPredictionPlacedEvent,
   isPredictionSettledEvent,
+  isPredictionVoidedEvent,
+  isWithdrawalCompletedEvent,
+  isWithdrawalFailedEvent,
   parseWebhookEvent,
   verifyWebhookSignature
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@puul/partner-sdk",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "Official TypeScript SDK for the Puul Partner API — integrate prediction markets into your platform",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -42,4 +42,4 @@
     "engines": {
         "node": ">=18.0.0"
     }
-}
+}