All notable changes documented here. Follows Keep a Changelog.
- Added Polygolem Wallet Intelligence V1 parity: read-only wallet dossier DTOs,
shrinkage scoring helpers, Data API-backed dossier/leaderboard/alert/market
flow service,
Polydart.intel,UniversalClientconvenience methods, and a local/mock E2E regression.
- Typed additional Polygolem Gamma metadata fields:
Market.marketType,Market.umaResolutionStatus,Market.readyTimestamp,Market.rewardsMinSize,Market.rewardsMaxSpread,Market.negRiskFeeBips,Event.subtitle,Event.subcategory,Event.sortBy,Event.isTemplate,Event.templateVariables,Event.createdBy,Event.updatedBy,Event.competitive,Event.featuredImage,Event.imageOptimized,Event.iconOptimized,Event.featuredImageOptimized,Event.disqusThread,Event.parentEvent,Event.isNew,Event.cyom,Event.showAllOutcomes,Event.showMarketImages,Event.automaticallyResolved,Event.enableNegRisk,Event.automaticallyActive,Event.seriesSlug,Event.eventWeek,Event.score,Event.elapsed,Event.period, andEvent.negRiskFeeBips. - Added Polygolem
pkg/orderfillsparity for on-chainOrderFilledtruth data, including public models, validation, reader interfaces, and a read-only Polygon JSON-RPC log reader foreth_getLogs/block timestamp decoding. - Added a mock-only Flutter Web deposit-wallet order smoke example that proves
the
WalletSignerapproval boundary andsignatureType=3payload path without live endpoints or raw private keys. - Matched Data API aggregate routing to current Polygolem endpoints:
/holders,/value,/traded,/oi,/v1/leaderboard, and/live-volume?id=.... - Flattened current
/holdersresponses and widened leaderboard decoding to Polygolem's current field aliases.
Polygolem parity commit:
07145d557738d576d2fb16bfa6a45fa5dffeea5d.
- Updated the Polygolem reference to a small upstream
.gitignorecleanup so tracked reference files are no longer reported as gitignored during Dart package validation. - Kept the hosted package archive filtered to the Dart SDK surface while
preserving
lib/src/**implementation files.
dart pub publish --dry-runnow validates with 0 warnings.
Polygolem parity commit:
5220881a08d512d58d31faca98f17fa184148407.
- Public alpha package metadata and release archive filtering for the hosted Dart package.
- Flutter app readiness documentation, source-pinned install options, lifecycle notes, wallet adapter guidance, and Flutter Web constraints.
- Errors: sealed
PolydartExceptionhierarchy with stableErrorCode. - Logging:
Loggerinterface, silent default, console sink. - Type primitives:
Decimal,NumericString,StringOrArray,NormalizedDateTime, enums (Side,OrderType,SignatureType). - CLOB / Gamma data classes (read-side subset).
- Transport:
HttpTransportwith retry, timeout, rate limit, circuit breaker, redaction helpers. - Config:
PolydartConfig.fromEnv+ Go-style duration parser. - Modes:
PolydartModeenum +requireLive/requirePaperOrLiveguards. - Gamma client:
health,search,markets,marketById,marketBySlug. - CLOB client:
health,serverTime,markets,market,orderBook,orderBooks,price,midpoint,spread,lastTradePrice,tickSize,pricesHistory. - Pagination:
CursorPager,OffsetPagerwithStream<T>access. - BookReader: top-of-book, midpoint, spread, depth aggregation.
- MarketResolver: slug / id →
ResolvedMarketwith token id helpers. - MarketDiscovery: Gamma + CLOB enrichment with parallel CLOB fan-out.
- Top-level
Polydartclient withreadOnlyandpaperfactories that share transports across sub-clients. - Live credential discovery:
LiveCredentialService,CredentialStore, andMemoryCredentialStorefor wallet-mediated CLOB L2 API key create/derive plus CLOB builder-fee key and Relayer V2 API-key creation without raw EOA private keys. - Deposit-wallet readiness can consume
LiveCredentialReadinessdirectly, build a Relayer V2 client from the relayer key, and return a blocked machine-readable state when credentials are incomplete. - Deposit-wallet readiness now checks the six V2 pUSD/CTF approvals plus CLOB
balance-allowancewithsignature_type=3, returningneedsApproval,needsFunding, orready. - Deposit-wallet limit-order placement now derives the deposit wallet from the
EOA signer, signs the ERC-7739
TypedDataSignenvelope, postssignatureType=3, and keeps CLOB HMAC auth EOA-bound. - Deposit-wallet market-order placement now supports Polygolem-compatible buy
market orders with explicit price or book-discovered fill price, using
signatureType=3and EOA-bound CLOB HMAC auth. - EOA pUSD funding route planning now reads the EOA pUSD balance, builds a
direct wallet transaction for
pUSD.transfer(depositWallet, amount), and reports full, partial, or unavailable funding state without submitting funds. - CI workflow: format, analyze, test (network tests opt-in).
- Order salt generation uses web-safe 32-bit bounds so Flutter Web consumers do not hit Dart-to-JavaScript integer precision limits.
- Public documentation now treats
WalletSigneras the app-owned approval boundary for any EOA/deposit-wallet operation.
- A Flutter Web consumer smoke path can depend on Polydart, request a wallet-mediated deposit-wallet order signature, and send the resulting order payload through a local mock CLOB endpoint.
- Alpha APIs remain unstable and may change before
1.0.0. - Live write paths remain lower-level and require explicit live mode,
liveTradingEnabled, user approval throughWalletSigner, and readiness checks. - Browser SIWE cookie login and Relayer V2 API-key minting are not directly
portable to Flutter Web because browsers do not expose
Set-Cookieto app code or allow arbitraryCookierequest headers. - Remaining parity gaps are tracked in
docs/POLYDART-POLYGOLEM-COVERAGE.md.