docs: sync with official Polymarket docs - 2026-04-20

docs/concepts/order-lifecycle.md

@@ -46,7 +46,7 @@ Post-only orders will only rest on the book. If a post-only order would match im
     * Side (buy or sell)
     * Price and size
     * Expiration time
-    * Nonce (for replay protection)
+    * Timestamp (in milliseconds, used for order uniqueness)
 
     You sign this order with your private key, creating an EIP712 signature.
   </Step>
@@ -75,7 +75,7 @@ Post-only orders will only rest on the book. If a post-only order would match im
 
     * Verifies both signatures
     * Transfers tokens from seller to buyer
-    * Transfers USDC.e from buyer to seller
+    * Transfers pUSD from buyer to seller
 
     Settlement is **atomic**—either the entire trade succeeds or nothing happens.
   </Step>
@@ -119,10 +119,7 @@ Price improvement always benefits the taker. If you place a buy order at `$0.55`
 
 ## Cancellation
 
-You can cancel orders at any time before they're matched:
-
-* **Via API** — Cancel through the CLOB API (instant)
-* **Onchain** — Cancel directly on the Exchange contract (fallback if API is unavailable)
+You can cancel orders at any time before they're matched via the CLOB API.
 
 Partial fills cannot be cancelled—only the unfilled portion of an order can be cancelled.
 
@@ -132,7 +129,7 @@ Before placing orders, ensure:
 
 | Requirement         | Description                                        |
 | ------------------- | -------------------------------------------------- |
-| **Balance**         | Sufficient USDC.e (for buys) or tokens (for sells) |
+| **Balance**         | Sufficient pUSD (for buys) or tokens (for sells)   |
 | **Allowance**       | Approve the Exchange contract to spend your assets |
 | **API Credentials** | Valid API key for authenticated endpoints          |
 

docs/concepts/positions-tokens.md

@@ -27,15 +27,15 @@ Tokens are **ERC1155** assets on Polygon, using the [Gnosis Conditional Token Fr
 
 <Note>
   Outcome tokens are always fully backed. Every Yes/No pair in existence is
-  backed by exactly `$1` of USDC.e collateral locked in the CTF contract.
+  backed by exactly `$1` of pUSD collateral locked in the CTF contract.
 </Note>
 
 ### Split
 
-Convert USDC.e into outcome tokens. Splitting \$1 creates 1 Yes token and 1 No token.
+Convert pUSD into outcome tokens. Splitting \$1 creates 1 Yes token and 1 No token.
 
 ```
-$100 USDC.e → 100 Yes tokens + 100 No tokens
+$100 pUSD → 100 Yes tokens + 100 No tokens
 ```
 
 Use this when you want to:
@@ -54,10 +54,10 @@ You can sell your position at any time before resolution.
 
 ### Merge
 
-Convert a complete set of tokens back into USDC.e. Merging requires equal amounts of Yes and No tokens.
+Convert a complete set of tokens back into pUSD. Merging requires equal amounts of Yes and No tokens.
 
 ```
-100 Yes tokens + 100 No tokens → $100 USDC.e
+100 Yes tokens + 100 No tokens → $100 pUSD
 ```
 
 Use this when you want to:
@@ -67,7 +67,7 @@ Use this when you want to:
 
 ### Redeem
 
-After a market resolves, exchange winning tokens for USDC.e.
+After a market resolves, exchange winning tokens for pUSD.
 
 | Outcome             | Yes tokens     | No tokens      |
 | ------------------- | -------------- | -------------- |
@@ -75,7 +75,7 @@ After a market resolves, exchange winning tokens for USDC.e.
 | Event doesn't occur | Worth \$0      | Worth \$1 each |
 
 ```
-100 winning tokens → $100 USDC.e
+100 winning tokens → $100 pUSD
 ```
 
 ### Position Value

docs/concepts/resolution.md

@@ -34,7 +34,7 @@ Every market has pre-defined resolution rules that specify:
     Anyone can propose a resolution by:
 
     1. Selecting the winning outcome
-    2. Posting a bond (typically \$750 USDC.e)
+    2. Posting a bond (typically \$750 pUSD)
     3. Submitting the proposal to the UMA Oracle
 
     If the proposal is correct and undisputed, the proposer receives their bond back plus a reward.
@@ -89,10 +89,10 @@ Once a market resolves:
 
 ### Redeeming Tokens
 
-After resolution, call the `redeemPositions` function on the CTF contract to exchange winning tokens for USDC.e. The contract burns your tokens and returns the corresponding collateral.
+After resolution, call the `redeemPositions` function on the CTF contract to exchange winning tokens for pUSD. The contract burns your tokens and returns the corresponding collateral.
 
 ```
-100 winning tokens → $100 USDC.e
+100 winning tokens → $100 pUSD
 ```
 
 ## Clarifications