@varla/polymarket 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# @varla/polymarket
+
+## 1.1.4
+
+### Patch Changes
+
+- cea1cf2: Added TypeScript declaration output and exports metadata for the Polymarket package.
+
+  - Publish generated type declarations and include them in the package exports
+  - Include CHANGELOG in published files and build types during prepack
+
+## 1.1.3
+
+### Patch Changes
+
+- 883517a: This release updates package metadata formatting with no functional changes.
+
+  - Reformatted the package.json files list without changing shipped contents.
+
+## 1.1.2
+
+### Patch Changes
+
+- 9bb27c7: No functional changes; updated package metadata formatting.
+
+  - Adjusted package.json files field formatting without affecting build output.
+
+## 1.1.1
+
+### Patch Changes
+
+- 5fdc094: Updated README to correct ClobWsClient feature description wording.
+
+  - Adjusted documentation to list "Auto-connect" for the ClobWsClient diagram.
+
+- 0d59e12: Updated package metadata formatting without functional changes.
+
+  - No functional changes; package file list formatting was adjusted.
+
+## 1.1.0
+
+### Minor Changes
+
+- 04689a5: Added new SDK types and expanded EIP-712 signer compatibility while tightening internal checks.
+
+  - Introduced OrderMarketCancelParams in SDK types for market cancel requests
+  - Expanded ClobEip712Signer to accept raw address strings for EIP-712 signing
+  - Improved internal cursor comparisons and builder auth checks
+
+### Patch Changes
+
+- 1cedbad: Align Polymarket API types with live responses and expand validation coverage while fixing a fetch usage bug.
+
+  - Updated DataApiClient to use the injected fetch function for book summaries.,- Expanded Gamma, CLOB, and Data API TypeScript types with additional optional fields and wider value shapes.,- Added comprehensive fixtures and schema-based tests to validate parsing against realistic and live API payloads.
+
+## 1.0.4
+
+### Patch Changes
+
+- 6857157: Package metadata formatting was updated with no functional changes.
+
+  - Reformatted the files list in package.json
+
+## 1.0.3
+
+### Patch Changes
+
+- 036a615: Release metadata updated with a new changelog and version bump.
+
+  - Added a changelog entry and bumped the package version to 1.0.2.
+
+## 1.0.2
+
+### Patch Changes
+
+- 803b77f: Updated README performance claims to a rounded value.
+
+  - Adjusted documented speed comparison from 139% to ~140% faster.

package/dist/abi/ctf-exchange.d.ts

@@ -0,0 +1,302 @@
+/**
+ * CTF Exchange ABI for Polymarket.
+ *
+ * This is the Conditional Token Framework Exchange contract ABI,
+ * used for order matching and settlement.
+ *
+ * Only includes functions needed for trading operations.
+ * Full ABI available in the official SDK examples.
+ *
+ * @see https://github.com/Polymarket/clob-client/blob/main/examples/abi/ctfAbi.ts
+ */
+export declare const ctfExchangeAbi: readonly [{
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "owners";
+        readonly type: "address[]";
+    }, {
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }];
+    readonly name: "balanceOfBatch";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly name: "isApprovedForAll";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+    readonly name: "setApprovalForAll";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly name: "safeTransferFrom";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "values";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly name: "safeBatchTransferFrom";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "collateralToken";
+        readonly type: "address";
+    }, {
+        readonly name: "parentCollectionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "conditionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "partition";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "splitPosition";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "collateralToken";
+        readonly type: "address";
+    }, {
+        readonly name: "parentCollectionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "conditionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "partition";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "mergePositions";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "collateralToken";
+        readonly type: "address";
+    }, {
+        readonly name: "parentCollectionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "conditionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "indexSets";
+        readonly type: "uint256[]";
+    }];
+    readonly name: "redeemPositions";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "conditionId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "getOutcomeSlotCount";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "oracle";
+        readonly type: "address";
+    }, {
+        readonly name: "questionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "outcomeSlotCount";
+        readonly type: "uint256";
+    }];
+    readonly name: "getConditionId";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "parentCollectionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "conditionId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "indexSet";
+        readonly type: "uint256";
+    }];
+    readonly name: "getCollectionId";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "collateralToken";
+        readonly type: "address";
+    }, {
+        readonly name: "collectionId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "getPositionId";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "pure";
+    readonly type: "function";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "TransferSingle";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }, {
+        readonly indexed: false;
+        readonly name: "values";
+        readonly type: "uint256[]";
+    }];
+    readonly name: "TransferBatch";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+    readonly name: "ApprovalForAll";
+    readonly type: "event";
+}];
+//# sourceMappingURL=ctf-exchange.d.ts.map

package/dist/abi/ctf-exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctf-exchange.d.ts","sourceRoot":"","sources":["../../src/abi/ctf-exchange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyLjB,CAAC"}

package/dist/abi/erc20.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Standard ERC20 ABI for USDC interactions.
+ *
+ * Used for checking balances, allowances, and approvals.
+ */
+export declare const erc20Abi: readonly [{
+    readonly inputs: readonly [];
+    readonly name: "name";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "symbol";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "decimals";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "totalSupply";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly name: "allowance";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "approve";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "transfer";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "transferFrom";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Transfer";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Approval";
+    readonly type: "event";
+}];
+//# sourceMappingURL=erc20.d.ts.map

package/dist/abi/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/abi/erc20.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsGX,CAAC"}

package/dist/abi/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Polymarket contract ABIs.
+ *
+ * @module @varla/polymarket/abi
+ */
+export { ctfExchangeAbi } from "./ctf-exchange.js";
+export { erc20Abi } from "./erc20.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/abi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/bridge-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Bridge API Client for Polymarket
+ *
+ * Provides access to deposit/withdrawal functionality through the Relay bridge.
+ *
+ * @see https://docs.polymarket.com/api-reference/bridge/create-deposit-addresses
+ */
+import type { BridgeDepositAddress, BridgeQuote, BridgeSupportedAsset, BridgeTransactionStatus, BridgeWithdrawalAddress } from "./types.js";
+export type BridgeClientOpts = {
+    /** Optional override for Bridge base URL. */
+    baseUrl?: string;
+    timeoutMs?: number;
+    maxAttempts?: number;
+    fetchFn?: typeof fetch;
+    retry?: {
+        baseBackoffMs?: number;
+        maxBackoffMs?: number;
+        multiplier?: number;
+        jitterFactor?: number;
+    };
+    log?: (level: "debug" | "info" | "warn" | "error", msg: string, fields?: Record<string, unknown>) => void;
+};
+export declare class BridgeClient {
+    readonly baseUrl: string;
+    readonly timeoutMs: number;
+    readonly maxAttempts: number;
+    readonly fetchFn: typeof fetch;
+    readonly retry: Required<NonNullable<BridgeClientOpts["retry"]>>;
+    readonly log?: BridgeClientOpts["log"];
+    constructor(opts?: BridgeClientOpts);
+    private isRetryable;
+    private requestGet;
+    private requestPost;
+    /**
+     * Create deposit addresses for a user.
+     * @see https://docs.polymarket.com/api-reference/bridge/create-deposit-addresses
+     */
+    createDepositAddresses(params: {
+        userAddress: string;
+        chain: string;
+        asset?: string;
+    }): Promise<BridgeDepositAddress>;
+    /**
+     * Create withdrawal addresses for a user.
+     * @see https://docs.polymarket.com/api-reference/bridge/create-withdrawal-addresses
+     */
+    createWithdrawalAddresses(params: {
+        userAddress: string;
+        destinationAddress: string;
+        chain: string;
+        asset: string;
+        amount: string;
+    }): Promise<BridgeWithdrawalAddress>;
+    /**
+     * Get a quote for a bridge transaction.
+     * @see https://docs.polymarket.com/api-reference/bridge/get-a-quote
+     */
+    getQuote(params: {
+        fromChain: string;
+        toChain: string;
+        fromAsset: string;
+        toAsset: string;
+        amount: string;
+    }): Promise<BridgeQuote>;
+    /**
+     * Get supported assets for bridging.
+     * @see https://docs.polymarket.com/api-reference/bridge/get-supported-assets
+     */
+    getSupportedAssets(): Promise<BridgeSupportedAsset[]>;
+    /**
+     * Get transaction status.
+     * @see https://docs.polymarket.com/api-reference/bridge/get-transaction-status
+     */
+    getTransactionStatus(transactionId: string): Promise<BridgeTransactionStatus>;
+}
+//# sourceMappingURL=bridge-client.d.ts.map

package/dist/bridge-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.d.ts","sourceRoot":"","sources":["../src/bridge-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAapB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAE3B,IAAI,GAAE,gBAAqB;IAcvC,OAAO,CAAC,WAAW;YASL,UAAU;YAuBV,WAAW;IAsCzB;;;OAGG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAajC;;;OAGG;IACG,yBAAyB,CAAC,MAAM,EAAE;QACtC,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAepC;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,CAAC;IAexB;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAS3D;;;OAGG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAIpF"}