@polyester/sdk 0.35.0-devnet-20261111025029 → 0.35.0-devnet-20261111140253
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +43 -1
- package/dist/catalogs/index.d.ts +2 -2
- package/dist/catalogs/snapshot-validation.js +7 -3
- package/dist/catalogs/snapshot-validation.js.map +1 -1
- package/dist/gen/ai/v1/assistant_pb.d.ts +4164 -0
- package/dist/gen/ai/v1/assistant_pb.d.ts.map +1 -0
- package/dist/gen/ai/v1/assistant_pb.js +1174 -0
- package/dist/gen/ai/v1/assistant_pb.js.map +1 -0
- package/dist/gen/alerts/v1/price_alerts_pb.d.ts +776 -0
- package/dist/gen/alerts/v1/price_alerts_pb.d.ts.map +1 -0
- package/dist/gen/alerts/v1/price_alerts_pb.js +378 -0
- package/dist/gen/alerts/v1/price_alerts_pb.js.map +1 -0
- package/dist/gen/auth/v1/address_book_pb.d.ts +6 -0
- package/dist/gen/auth/v1/address_book_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/address_book_pb.js +6 -0
- package/dist/gen/auth/v1/address_book_pb.js.map +1 -1
- package/dist/gen/auth/v1/api_keys_pb.d.ts +247 -3
- package/dist/gen/auth/v1/api_keys_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/api_keys_pb.js +81 -2
- package/dist/gen/auth/v1/api_keys_pb.js.map +1 -1
- package/dist/gen/auth/v1/auth_pb.d.ts +55 -6
- package/dist/gen/auth/v1/auth_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/auth_pb.js +55 -6
- package/dist/gen/auth/v1/auth_pb.js.map +1 -1
- package/dist/gen/auth/v1/policies_pb.d.ts +186 -14
- package/dist/gen/auth/v1/policies_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/policies_pb.js +163 -6
- package/dist/gen/auth/v1/policies_pb.js.map +1 -1
- package/dist/gen/auth/v1/profile_pb.d.ts +4 -2
- package/dist/gen/auth/v1/profile_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/profile_pb.js.map +1 -1
- package/dist/gen/auth/v1/resolve_pb.d.ts +1 -0
- package/dist/gen/auth/v1/resolve_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/resolve_pb.js.map +1 -1
- package/dist/gen/auth/v1/social_verification_pb.d.ts +170 -11
- package/dist/gen/auth/v1/social_verification_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/social_verification_pb.js +41 -3
- package/dist/gen/auth/v1/social_verification_pb.js.map +1 -1
- package/dist/gen/auth/v1/subaccounts_pb.d.ts +25 -9
- package/dist/gen/auth/v1/subaccounts_pb.d.ts.map +1 -1
- package/dist/gen/auth/v1/subaccounts_pb.js.map +1 -1
- package/dist/gen/chain/deposit/v1/deposit_pb.d.ts +4 -2
- package/dist/gen/chain/deposit/v1/deposit_pb.d.ts.map +1 -1
- package/dist/gen/chain/deposit/v1/deposit_pb.js.map +1 -1
- package/dist/gen/chain/guard/v1/guard_signer_pb.d.ts +5 -0
- package/dist/gen/chain/guard/v1/guard_signer_pb.d.ts.map +1 -1
- package/dist/gen/chain/guard/v1/guard_signer_pb.js.map +1 -1
- package/dist/gen/chain/lifecycle/v1/lifecycle_read_pb.d.ts +10 -0
- package/dist/gen/chain/lifecycle/v1/lifecycle_read_pb.d.ts.map +1 -1
- package/dist/gen/chain/lifecycle/v1/lifecycle_read_pb.js +1 -1
- package/dist/gen/chain/lifecycle/v1/lifecycle_read_pb.js.map +1 -1
- package/dist/gen/chain/lifecycle/v1/types_pb.d.ts +32 -4
- package/dist/gen/chain/lifecycle/v1/types_pb.d.ts.map +1 -1
- package/dist/gen/chain/lifecycle/v1/types_pb.js +32 -4
- package/dist/gen/chain/lifecycle/v1/types_pb.js.map +1 -1
- package/dist/gen/chain/withdraw/v1/auto_withdraw_pb.d.ts +391 -42
- package/dist/gen/chain/withdraw/v1/auto_withdraw_pb.d.ts.map +1 -1
- package/dist/gen/chain/withdraw/v1/auto_withdraw_pb.js +103 -17
- package/dist/gen/chain/withdraw/v1/auto_withdraw_pb.js.map +1 -1
- package/dist/gen/chain/withdraw/v1/withdraw_pb.d.ts +172 -4
- package/dist/gen/chain/withdraw/v1/withdraw_pb.d.ts.map +1 -1
- package/dist/gen/chain/withdraw/v1/withdraw_pb.js +63 -2
- package/dist/gen/chain/withdraw/v1/withdraw_pb.js.map +1 -1
- package/dist/gen/chain/zipper/v1/zipper_pb.d.ts +57 -3
- package/dist/gen/chain/zipper/v1/zipper_pb.d.ts.map +1 -1
- package/dist/gen/chain/zipper/v1/zipper_pb.js +41 -3
- package/dist/gen/chain/zipper/v1/zipper_pb.js.map +1 -1
- package/dist/gen/checkpoints/v1/checkpoints_pb.d.ts +2 -1
- package/dist/gen/checkpoints/v1/checkpoints_pb.d.ts.map +1 -1
- package/dist/gen/checkpoints/v1/checkpoints_pb.js.map +1 -1
- package/dist/gen/claims/v1/claims_pb.d.ts +20 -3
- package/dist/gen/claims/v1/claims_pb.d.ts.map +1 -1
- package/dist/gen/claims/v1/claims_pb.js +12 -3
- package/dist/gen/claims/v1/claims_pb.js.map +1 -1
- package/dist/gen/index.d.ts +9 -5
- package/dist/gen/index.js +5 -1
- package/dist/gen/ledger/v1/catalog_pb.d.ts +52 -1
- package/dist/gen/ledger/v1/catalog_pb.d.ts.map +1 -1
- package/dist/gen/ledger/v1/catalog_pb.js +52 -1
- package/dist/gen/ledger/v1/catalog_pb.js.map +1 -1
- package/dist/gen/marketdata/v1/heatmap_pb.d.ts +6 -0
- package/dist/gen/marketdata/v1/heatmap_pb.d.ts.map +1 -1
- package/dist/gen/marketdata/v1/heatmap_pb.js.map +1 -1
- package/dist/gen/marketdata/v1/marketdata_pb.d.ts +8 -0
- package/dist/gen/marketdata/v1/marketdata_pb.d.ts.map +1 -1
- package/dist/gen/marketdata/v1/marketdata_pb.js +1 -1
- package/dist/gen/marketdata/v1/marketdata_pb.js.map +1 -1
- package/dist/gen/orders/v1/orders_pb.d.ts +29 -8
- package/dist/gen/orders/v1/orders_pb.d.ts.map +1 -1
- package/dist/gen/orders/v1/orders_pb.js +18 -5
- package/dist/gen/orders/v1/orders_pb.js.map +1 -1
- package/dist/gen/polyester/ratelimit/v1/types_pb.d.ts +20 -1
- package/dist/gen/polyester/ratelimit/v1/types_pb.d.ts.map +1 -1
- package/dist/gen/polyester/ratelimit/v1/types_pb.js +20 -1
- package/dist/gen/polyester/ratelimit/v1/types_pb.js.map +1 -1
- package/dist/gen/rewards/v1/rewards_pb.d.ts +74 -3
- package/dist/gen/rewards/v1/rewards_pb.d.ts.map +1 -1
- package/dist/gen/rewards/v1/rewards_pb.js +16 -4
- package/dist/gen/rewards/v1/rewards_pb.js.map +1 -1
- package/dist/gen/swap/quickswap/v1/quickswap_broker_pb.d.ts +1268 -67
- package/dist/gen/swap/quickswap/v1/quickswap_broker_pb.d.ts.map +1 -1
- package/dist/gen/swap/quickswap/v1/quickswap_broker_pb.js +306 -5
- package/dist/gen/swap/quickswap/v1/quickswap_broker_pb.js.map +1 -1
- package/dist/gen/swap/quickswap/v1/quickswap_pb.d.ts +298 -54
- package/dist/gen/swap/quickswap/v1/quickswap_pb.d.ts.map +1 -1
- package/dist/gen/swap/quickswap/v1/quickswap_pb.js +183 -37
- package/dist/gen/swap/quickswap/v1/quickswap_pb.js.map +1 -1
- package/dist/gen/swap/quickswap/v1/quickswap_referral_pb.d.ts +933 -0
- package/dist/gen/swap/quickswap/v1/quickswap_referral_pb.d.ts.map +1 -0
- package/dist/gen/swap/quickswap/v1/quickswap_referral_pb.js +292 -0
- package/dist/gen/swap/quickswap/v1/quickswap_referral_pb.js.map +1 -0
- package/dist/gen/system/v1/system_pb.d.ts +77 -0
- package/dist/gen/system/v1/system_pb.d.ts.map +1 -0
- package/dist/gen/system/v1/system_pb.js +34 -0
- package/dist/gen/system/v1/system_pb.js.map +1 -0
- package/dist/gen/tradews/v1/trade_ws_pb.d.ts +2 -2
- package/dist/gen/tradews/v1/trade_ws_pb.js.map +1 -1
- package/dist/gen/transfer/v1/internal_transfer_pb.d.ts +101 -2
- package/dist/gen/transfer/v1/internal_transfer_pb.d.ts.map +1 -1
- package/dist/gen/transfer/v1/internal_transfer_pb.js +14 -2
- package/dist/gen/transfer/v1/internal_transfer_pb.js.map +1 -1
- package/dist/gen/vip/v1/vip_pb.d.ts +1 -0
- package/dist/gen/vip/v1/vip_pb.d.ts.map +1 -1
- package/dist/gen/vip/v1/vip_pb.js.map +1 -1
- package/dist/index.d.ts +9 -9
- package/dist/index.js +2 -2
- package/dist/services/address-book/address-book.schemas.d.ts +2 -2
- package/dist/services/api-keys/api-keys.codecs.js +10 -1
- package/dist/services/api-keys/api-keys.codecs.js.map +1 -1
- package/dist/services/api-keys/api-keys.schemas.d.ts +4 -0
- package/dist/services/api-keys/api-keys.schemas.d.ts.map +1 -1
- package/dist/services/api-keys/api-keys.schemas.js +3 -1
- package/dist/services/api-keys/api-keys.schemas.js.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.codecs.d.ts +9 -2
- package/dist/services/auto-withdraw/auto-withdraw.codecs.d.ts.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.codecs.js +9 -1
- package/dist/services/auto-withdraw/auto-withdraw.codecs.js.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.d.ts +15 -4
- package/dist/services/auto-withdraw/auto-withdraw.d.ts.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.js +24 -8
- package/dist/services/auto-withdraw/auto-withdraw.js.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.schemas.d.ts +375 -7
- package/dist/services/auto-withdraw/auto-withdraw.schemas.d.ts.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.schemas.js +66 -11
- package/dist/services/auto-withdraw/auto-withdraw.schemas.js.map +1 -1
- package/dist/services/auto-withdraw/auto-withdraw.types.d.ts +3 -3
- package/dist/services/changelog/changelog.schemas.d.ts +17 -17
- package/dist/services/checkpoints/checkpoints.schemas.d.ts +2 -2
- package/dist/services/claims/claims.d.ts +5 -2
- package/dist/services/claims/claims.d.ts.map +1 -1
- package/dist/services/claims/claims.js +5 -2
- package/dist/services/claims/claims.js.map +1 -1
- package/dist/services/heatmap/heatmap.schemas.d.ts +4 -4
- package/dist/services/internal-transfers/internal-transfers.d.ts +13 -4
- package/dist/services/internal-transfers/internal-transfers.d.ts.map +1 -1
- package/dist/services/internal-transfers/internal-transfers.js +17 -3
- package/dist/services/internal-transfers/internal-transfers.js.map +1 -1
- package/dist/services/internal-transfers/internal-transfers.schemas.d.ts +59 -4
- package/dist/services/internal-transfers/internal-transfers.schemas.d.ts.map +1 -1
- package/dist/services/internal-transfers/internal-transfers.schemas.js +32 -2
- package/dist/services/internal-transfers/internal-transfers.schemas.js.map +1 -1
- package/dist/services/internal-transfers/internal-transfers.types.d.ts +2 -2
- package/dist/services/lifecycle/lifecycle.codecs.d.ts +2 -2
- package/dist/services/lifecycle/lifecycle.codecs.d.ts.map +1 -1
- package/dist/services/lifecycle/lifecycle.codecs.js +3 -1
- package/dist/services/lifecycle/lifecycle.codecs.js.map +1 -1
- package/dist/services/lifecycle/lifecycle.schemas.d.ts +114 -90
- package/dist/services/lifecycle/lifecycle.schemas.d.ts.map +1 -1
- package/dist/services/lifecycle/lifecycle.schemas.js +7 -1
- package/dist/services/lifecycle/lifecycle.schemas.js.map +1 -1
- package/dist/services/market-data/market-data.schemas.js +7 -2
- package/dist/services/market-data/market-data.schemas.js.map +1 -1
- package/dist/services/orderbook/orderbook.schemas.d.ts +1 -1
- package/dist/services/orders/order-errors.schemas.d.ts +2 -2
- package/dist/services/orders/orders-batch.schemas.d.ts +54 -54
- package/dist/services/orders/orders-input.schemas.d.ts +7 -7
- package/dist/services/orders/orders-output.schemas.d.ts +19 -19
- package/dist/services/orders/orders.d.ts +2 -0
- package/dist/services/orders/orders.d.ts.map +1 -1
- package/dist/services/orders/orders.js +2 -0
- package/dist/services/orders/orders.js.map +1 -1
- package/dist/services/policies/api-key-policies/api-key-policies.schemas.d.ts +15 -15
- package/dist/services/policies/api-key-policies/api-key-policies.schemas.js +1 -1
- package/dist/services/policies/shared.codecs.js +85 -3
- package/dist/services/policies/shared.codecs.js.map +1 -1
- package/dist/services/policies/shared.d.ts +1 -1
- package/dist/services/policies/shared.d.ts.map +1 -1
- package/dist/services/policies/shared.js +5 -14
- package/dist/services/policies/shared.js.map +1 -1
- package/dist/services/policies/subaccount-policies/subaccount-policies.schemas.d.ts +3 -3
- package/dist/services/policies/subaccount-policies/subaccount-policies.schemas.js +3 -3
- package/dist/services/policies/subaccount-policies/subaccount-policies.schemas.js.map +1 -1
- package/dist/services/rewards/rewards.d.ts +13 -3
- package/dist/services/rewards/rewards.d.ts.map +1 -1
- package/dist/services/rewards/rewards.js +17 -3
- package/dist/services/rewards/rewards.js.map +1 -1
- package/dist/services/rewards/rewards.schemas.d.ts +101 -4
- package/dist/services/rewards/rewards.schemas.d.ts.map +1 -1
- package/dist/services/rewards/rewards.schemas.js +12 -2
- package/dist/services/rewards/rewards.schemas.js.map +1 -1
- package/dist/services/rewards/rewards.types.d.ts +2 -2
- package/dist/services/social-verification/social-verification.codecs.js +13 -5
- package/dist/services/social-verification/social-verification.codecs.js.map +1 -1
- package/dist/services/social-verification/social-verification.d.ts +18 -3
- package/dist/services/social-verification/social-verification.d.ts.map +1 -1
- package/dist/services/social-verification/social-verification.js +26 -3
- package/dist/services/social-verification/social-verification.js.map +1 -1
- package/dist/services/social-verification/social-verification.schemas.d.ts +33 -7
- package/dist/services/social-verification/social-verification.schemas.d.ts.map +1 -1
- package/dist/services/social-verification/social-verification.schemas.js +35 -10
- package/dist/services/social-verification/social-verification.schemas.js.map +1 -1
- package/dist/services/social-verification/social-verification.types.d.ts +2 -2
- package/dist/services/subaccounts/subaccounts.schemas.d.ts +17 -17
- package/dist/services/trades/trades.schemas.d.ts +2 -2
- package/dist/services/trading-withdraws/trading-withdraws.d.ts +7 -1
- package/dist/services/trading-withdraws/trading-withdraws.d.ts.map +1 -1
- package/dist/services/trading-withdraws/trading-withdraws.js +11 -1
- package/dist/services/trading-withdraws/trading-withdraws.js.map +1 -1
- package/dist/services/trading-withdraws/trading-withdraws.schemas.d.ts +42 -1
- package/dist/services/trading-withdraws/trading-withdraws.schemas.d.ts.map +1 -1
- package/dist/services/trading-withdraws/trading-withdraws.schemas.js +19 -3
- package/dist/services/trading-withdraws/trading-withdraws.schemas.js.map +1 -1
- package/dist/services/trading-withdraws/trading-withdraws.types.d.ts +2 -2
- package/dist/services/transfers/transfers.schemas.d.ts +4 -4
- package/dist/services/triggers/trigger-input.schemas.d.ts +2 -2
- package/dist/services/triggers/triggers-output.schemas.d.ts +30 -30
- package/dist/services/zipper/zipper.schemas.d.ts +2 -2
- package/dist/services/zipper/zipper.schemas.d.ts.map +1 -1
- package/dist/services/zipper/zipper.schemas.js +13 -2
- package/dist/services/zipper/zipper.schemas.js.map +1 -1
- package/dist/services/zipper/zipper.types.d.ts +2 -2
- package/dist/shared/catalog-config.d.ts +18 -1
- package/dist/shared/catalog-config.d.ts.map +1 -1
- package/dist/shared/catalog-config.js +7 -1
- package/dist/shared/catalog-config.js.map +1 -1
- package/dist/shared/connect-error-mapping.d.ts.map +1 -1
- package/dist/shared/connect-error-mapping.js +5 -1
- package/dist/shared/connect-error-mapping.js.map +1 -1
- package/dist/shared/error-detail.d.ts +8 -0
- package/dist/shared/error-detail.d.ts.map +1 -1
- package/dist/shared/error-detail.js.map +1 -1
- package/dist/shared/error-details/claims.js +7 -2
- package/dist/shared/error-details/claims.js.map +1 -1
- package/dist/shared/error-details/withdraw.js +11 -2
- package/dist/shared/error-details/withdraw.js.map +1 -1
- package/dist/shared/errors.d.ts +20 -3
- package/dist/shared/errors.d.ts.map +1 -1
- package/dist/shared/errors.js +17 -1
- package/dist/shared/errors.js.map +1 -1
- package/dist/shared/ledger-codes.d.ts +7 -1
- package/dist/shared/ledger-codes.d.ts.map +1 -1
- package/dist/shared/ledger-codes.js +27 -3
- package/dist/shared/ledger-codes.js.map +1 -1
- package/dist/shared/rate-limit.schemas.d.ts +2 -2
- package/dist/shared/rate-limit.schemas.d.ts.map +1 -1
- package/dist/shared/rate-limit.schemas.js +4 -1
- package/dist/shared/rate-limit.schemas.js.map +1 -1
- package/dist/shared/transports.d.ts +2 -1
- package/dist/shared/transports.d.ts.map +1 -1
- package/dist/shared/transports.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { PolyesterErrorDetail } from \"./error-detail.js\";\nexport type { PolyesterErrorDetail } from \"./error-detail.js\";\nimport type { RateLimitDetail } from \"./rate-limit.schemas.js\";\n\n/**\n * Typed error hierarchy for the Polyester SDK.\n *\n * Every error raised by the SDK extends {@link PolyesterError}, which carries a\n * stable machine-readable `code` and a `retryable` flag. The tree splits on\n * retryability so callers can triage with a single `instanceof` check:\n *\n * ```\n * PolyesterError code retryable\n * ├── TransientError TRANSIENT_FAILURE true\n * │ ├── NetworkError NETWORK_ERROR true\n * │ ├── TimeoutError TIMEOUT true\n * │ ├── RateLimitError RATE_LIMITED true\n * │ ├── TimestampSkewError TIMESTAMP_SKEW true\n * │ │ └── RequestDeadlineExceededError REQUEST_DEADLINE_EXCEEDED\n * │ └── ServiceUnavailableError SERVICE_UNAVAILABLE true\n * ├── RequestError REQUEST_FAILED false\n * │ ├── ValidationError VALIDATION_FAILED false\n * │ │ ├── StaleQuoteError STALE_QUOTE\n * │ │ ├── WithdrawDeadlineExpiredError WITHDRAW_DEADLINE_EXPIRED\n * │ │ └── PolicyScopeMismatchError POLICY_SCOPE_MISMATCH\n * │ ├── ResourceNotFoundError RESOURCE_NOT_FOUND false\n * │ ├── RequestTooLargeError REQUEST_TOO_LARGE false\n * │ ├── NotImplementedError NOT_IMPLEMENTED false\n * │ ├── AlreadyExistsError ALREADY_EXISTS false\n * │ │ └── UserOperationAlreadyKnownError USER_OPERATION_ALREADY_KNOWN\n * │ ├── PermissionError PERMISSION_DENIED false\n * │ ├── AuthenticationError UNAUTHENTICATED false\n * │ ├── PreconditionFailedError PRECONDITION_FAILED false\n * │ │ ├── RevisionConflictError REVISION_CONFLICT\n * │ │ ├── PolicyInUseError POLICY_IN_USE\n * │ │ ├── PolicyLockedError POLICY_LOCKED\n * │ │ ├── SubaccountChallengeInvalidError SUBACCOUNT_CHALLENGE_INVALID\n * │ │ └── MfaLastFactorRequiredError MFA_LAST_FACTOR_REQUIRED\n * │ ├── ConfigurationError INVALID_CONFIGURATION false\n * │ ├── MfaRequiredError MFA_REQUIRED false\n * │ │ ├── MfaEnrollmentRequiredError MFA_ENROLLMENT_REQUIRED\n * │ │ ├── StepUpRequiredError STEP_UP_REQUIRED\n * │ │ └── SessionElevationRequiredError SESSION_ELEVATION_REQUIRED\n * │ ├── MfaVerificationError MFA_VERIFICATION_FAILED false\n * │ ├── UserOperationSendTimeoutError USER_OPERATION_SEND_TIMEOUT false\n * │ ├── OutcomeUnknownError OUTCOME_UNKNOWN false\n * │ └── UserOperationNotExecutedError USER_OPERATION_NOT_EXECUTED false\n * ├── InternalServerError INTERNAL_SERVER_ERROR false\n * └── RealtimeError REALTIME_ERROR varies\n * ```\n *\n * Catalog errors (`CatalogLookupError`, `CatalogConversionError`, …) plug into\n * the same tree under `RequestError`/`ValidationError`.\n *\n * Errors mapped from RPC failures keep the original `ConnectError` as `cause`\n * and carry the response's `status` when available.\n *\n * @example\n * ```ts\n * try {\n * await client.orders.createSpotOrder(input);\n * } catch (err) {\n * if (err instanceof RateLimitError) await sleep(err.retryAfterMs ?? 1000);\n * else if (err instanceof TransientError) retry();\n * else if (err instanceof StepUpRequiredError) promptForMfa();\n * else throw err;\n * }\n * ```\n */\n\n/** Stable machine-readable codes carried by built-in SDK errors. */\nexport type PolyesterErrorCode =\n | \"TRANSIENT_FAILURE\"\n | \"NETWORK_ERROR\"\n | \"TIMEOUT\"\n | \"RATE_LIMITED\"\n | \"TIMESTAMP_SKEW\"\n | \"REQUEST_DEADLINE_EXCEEDED\"\n | \"SERVICE_UNAVAILABLE\"\n | \"REQUEST_FAILED\"\n | \"VALIDATION_FAILED\"\n | \"STALE_QUOTE\"\n | \"WITHDRAW_DEADLINE_EXPIRED\"\n | \"RESOURCE_NOT_FOUND\"\n | \"REQUEST_TOO_LARGE\"\n | \"NOT_IMPLEMENTED\"\n | \"ALREADY_EXISTS\"\n | \"USER_OPERATION_ALREADY_KNOWN\"\n | \"USER_OPERATION_SEND_TIMEOUT\"\n | \"OUTCOME_UNKNOWN\"\n | \"USER_OPERATION_NOT_EXECUTED\"\n | \"PERMISSION_DENIED\"\n | \"UNAUTHENTICATED\"\n | \"PRECONDITION_FAILED\"\n | \"REVISION_CONFLICT\"\n | \"SUBACCOUNT_CHALLENGE_INVALID\"\n | \"POLICY_IN_USE\"\n | \"POLICY_LOCKED\"\n | \"POLICY_SCOPE_MISMATCH\"\n | \"INVALID_CONFIGURATION\"\n | \"MFA_REQUIRED\"\n | \"MFA_ENROLLMENT_REQUIRED\"\n | \"STEP_UP_REQUIRED\"\n | \"SESSION_ELEVATION_REQUIRED\"\n | \"MFA_LAST_FACTOR_REQUIRED\"\n | \"MFA_VERIFICATION_FAILED\"\n | \"INTERNAL_SERVER_ERROR\"\n | \"REALTIME_ERROR\"\n | \"CATALOG_LOOKUP_MISS\"\n | \"CATALOG_NOT_READY\"\n | \"CATALOG_CONVERSION_INVALID\"\n | \"CATALOG_VALIDATION_FAILED\";\n\nexport interface PolyesterErrorOptions {\n /** Underlying error, typically the original `ConnectError` for RPC failures. */\n cause?: unknown;\n /** Recognized structured backend rejection, decoded at the RPC boundary. */\n detail?: PolyesterErrorDetail;\n /** HTTP status of the failed response. */\n status?: number;\n}\n\nconst CONNECT_ERROR_PREFIX_RE = /^(?:\\[[a-z][a-z0-9_-]*]\\s*)+/i;\n\nexport function normalizeErrorMessage(message: string): string {\n return message.replace(CONNECT_ERROR_PREFIX_RE, \"\").trim();\n}\n\n/**\n * Base class for every error raised by the Polyester SDK.\n *\n * Check `retryable` (or `instanceof TransientError`) to decide whether the\n * same call can be safely retried, and switch on `code` for exhaustive,\n * minification-safe handling.\n */\nexport abstract class PolyesterError extends Error {\n /** Stable machine-readable error code, e.g. `\"RATE_LIMITED\"`. */\n abstract readonly code: string;\n /** Whether retrying the same operation may succeed. */\n abstract readonly retryable: boolean;\n readonly detail: PolyesterErrorDetail | undefined;\n /**\n * HTTP status of the failed response. For Connect errors that carry no raw\n * HTTP status, the Connect protocol's status for the error code.\n */\n readonly status: number | undefined;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(normalizeErrorMessage(message), options);\n this.name = \"PolyesterError\";\n const inherited = options?.cause instanceof PolyesterError ? options.cause : undefined;\n this.detail = options?.detail ?? inherited?.detail;\n this.status = options?.status ?? inherited?.status;\n }\n}\n\n/**\n * A transient failure — the request may never have reached the backend or the\n * backend was temporarily unable to serve it. Follow the operation's retry\n * contract: reuse requestId for idempotent mutations. For single-order creation,\n * reconcile by clientOrderId; reusing it returns a conflict rather than replay.\n */\nexport class TransientError extends PolyesterError {\n readonly code: string = \"TRANSIENT_FAILURE\";\n readonly retryable = true;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TransientError\";\n }\n}\n\n/** The request could not be sent or the connection failed mid-flight. */\nexport class NetworkError extends TransientError {\n override readonly code: string = \"NETWORK_ERROR\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"NetworkError\";\n }\n}\n\n/** The request timed out before the backend produced a response. */\nexport class TimeoutError extends TransientError {\n override readonly code: string = \"TIMEOUT\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TimeoutError\";\n }\n}\n\nexport interface RateLimitErrorOptions extends PolyesterErrorOptions {\n /** Suggested wait before retrying, when the backend provided one. */\n retryAfterMs?: number;\n /** Structured quota state attached to the rejection, when provided. */\n rateLimit?: RateLimitDetail;\n}\n\n/** The backend rejected the request due to rate limiting. */\nexport class RateLimitError extends TransientError {\n override readonly code: string = \"RATE_LIMITED\";\n /** Suggested wait before retrying, in milliseconds, when known. */\n readonly retryAfterMs?: number;\n /** Structured quota state attached to the rejection, when provided. */\n readonly rateLimit?: RateLimitDetail;\n\n constructor(message: string, options?: RateLimitErrorOptions) {\n super(message, options);\n this.name = \"RateLimitError\";\n this.retryAfterMs = options?.retryAfterMs;\n this.rateLimit = options?.rateLimit;\n }\n}\n\n/**\n * The API-key signature timestamp fell outside the backend's skew window, e.g.\n * because the request waited too long in the runtime's fetch queue during a\n * large concurrent burst, or the local clock drifted. Retrying the call signs\n * it again with a fresh timestamp; bound concurrency if it recurs.\n */\nexport class TimestampSkewError extends TransientError {\n override readonly code: string = \"TIMESTAMP_SKEW\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TimestampSkewError\";\n }\n}\n\n/**\n * A signed order or trigger write passed authentication, but its receive window\n * (`X-API-TIMESTAMP` plus `recvWindow`) ended before it was sent on for admission.\n * Nothing changed and it is never an unknown outcome, so retrying the call, which\n * signs it again with a fresh timestamp, is safe.\n */\nexport class RequestDeadlineExceededError extends TimestampSkewError {\n override readonly code: string = \"REQUEST_DEADLINE_EXCEEDED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestDeadlineExceededError\";\n }\n}\n\n/** The backend is temporarily unavailable (e.g. overloaded or restarting). */\nexport class ServiceUnavailableError extends TransientError {\n override readonly code: string = \"SERVICE_UNAVAILABLE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ServiceUnavailableError\";\n }\n}\n\n/**\n * The request itself was rejected — retrying the identical call will fail the\n * same way. Fix the input, authentication, or permissions first.\n */\nexport class RequestError extends PolyesterError {\n readonly code: string = \"REQUEST_FAILED\";\n readonly retryable = false;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestError\";\n }\n}\n\n/** The request input failed validation (client- or server-side). */\nexport class ValidationError extends RequestError {\n override readonly code: string = \"VALIDATION_FAILED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ValidationError\";\n }\n}\n\n/** The submitted client reference quote exceeded the market's configured drift limit. */\nexport class StaleQuoteError extends ValidationError {\n override readonly code = \"STALE_QUOTE\" as const;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"StaleQuoteError\";\n }\n}\n\n/**\n * The prepared withdraw's signed deadline has passed, so the backend would\n * reject it. Prepare (and sign) the withdraw again.\n *\n * Thrown by `submit` before sending once the deadline has passed, and when the\n * backend rejects the deadline as expired: one that lapsed in flight, or one\n * signed from a device clock running behind the server's.\n */\nexport class WithdrawDeadlineExpiredError extends ValidationError {\n override readonly code: string = \"WITHDRAW_DEADLINE_EXPIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"WithdrawDeadlineExpiredError\";\n }\n}\n\n/**\n * The request body was over the endpoint's size limit (HTTP 413). The limit is\n * fixed per endpoint, so the same request fails again; send a smaller one.\n */\nexport class RequestTooLargeError extends RequestError {\n override readonly code: string = \"REQUEST_TOO_LARGE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestTooLargeError\";\n }\n}\n\n/** The requested resource does not exist (or is not visible to the caller). */\nexport class ResourceNotFoundError extends RequestError {\n override readonly code: string = \"RESOURCE_NOT_FOUND\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ResourceNotFoundError\";\n }\n}\n\n/** The backend does not implement the requested operation (HTTP 501 / Connect `unimplemented`). */\nexport class NotImplementedError extends RequestError {\n override readonly code: string = \"NOT_IMPLEMENTED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"NotImplementedError\";\n }\n}\n\n/** The resource already exists (e.g. a duplicate `clientOrderId`). */\nexport class AlreadyExistsError extends RequestError {\n override readonly code: string = \"ALREADY_EXISTS\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"AlreadyExistsError\";\n }\n}\n\n/**\n * The bundler already holds this exact UserOperation (it answered \"Already\n * known\"), so the earlier submission is still pending. Wait on `userOpHash`\n * instead of signing again; a new operation would execute a second time.\n */\nexport class UserOperationAlreadyKnownError extends AlreadyExistsError {\n override readonly code: string = \"USER_OPERATION_ALREADY_KNOWN\";\n readonly userOpHash: `0x${string}`;\n\n constructor(message: string, userOpHash: `0x${string}`, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"UserOperationAlreadyKnownError\";\n this.userOpHash = userOpHash;\n }\n}\n\n/**\n * `eth_sendUserOperation` timed out after the UserOperation was signed. The\n * bundler may still have accepted it, so the outcome is unknown rather than\n * rejected. Wait on `userOpHash` instead of signing again; a new operation\n * could execute a second time. Not retryable for the same reason.\n */\nexport class UserOperationSendTimeoutError extends RequestError {\n override readonly code: string = \"USER_OPERATION_SEND_TIMEOUT\";\n readonly userOpHash: `0x${string}`;\n\n constructor(message: string, userOpHash: `0x${string}`, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"UserOperationSendTimeoutError\";\n this.userOpHash = userOpHash;\n }\n}\n\n/**\n * An order or trigger change was sent but not confirmed in time, so it may\n * still apply. Not retryable: read the order by its client order ID, or list\n * triggers by client trigger ID, before sending it again. `detail.code` names\n * the operation, e.g. `ORDER_CREATE_OUTCOME_UNKNOWN`.\n */\nexport class OutcomeUnknownError extends RequestError {\n override readonly code: string = \"OUTCOME_UNKNOWN\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"OutcomeUnknownError\";\n }\n}\n\n/** The caller is authenticated but not allowed to perform this operation. */\nexport class PermissionError extends RequestError {\n override readonly code: string = \"PERMISSION_DENIED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PermissionError\";\n }\n}\n\n/** The caller is not authenticated (missing, expired, or invalid credentials). */\nexport class AuthenticationError extends RequestError {\n override readonly code: string = \"UNAUTHENTICATED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"AuthenticationError\";\n }\n}\n\n/** The system is not in a state that allows this operation (e.g. insufficient balance). */\nexport class PreconditionFailedError extends RequestError {\n override readonly code: string = \"PRECONDITION_FAILED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PreconditionFailedError\";\n }\n}\n\n/**\n * The resource changed after it was read, so the submitted expected revision\n * is stale. Refetch and let the caller reconcile; do not blindly retry.\n */\nexport class RevisionConflictError extends PreconditionFailedError {\n override readonly code: string = \"REVISION_CONFLICT\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RevisionConflictError\";\n }\n}\n\n/**\n * The subaccount authorization is expired, replaced by a newer challenge, already\n * consumed, or has an invalid signature. Request a fresh challenge via\n * `subaccounts.createChallenge`. Temporary verification failures surface as\n * `ServiceUnavailableError` instead; retry those with the same signed challenge.\n */\nexport class SubaccountChallengeInvalidError extends PreconditionFailedError {\n override readonly code: string = \"SUBACCOUNT_CHALLENGE_INVALID\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"SubaccountChallengeInvalidError\";\n }\n}\n\n/** The policy cannot be removed while accounts or API keys still use it. */\nexport class PolicyInUseError extends PreconditionFailedError {\n override readonly code: string = \"POLICY_IN_USE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyInUseError\";\n }\n}\n\n/** The policy is locked against the requested mutation. */\nexport class PolicyLockedError extends PreconditionFailedError {\n override readonly code: string = \"POLICY_LOCKED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyLockedError\";\n }\n}\n\n/** The policy does not belong to the account scope targeted by the request. */\nexport class PolicyScopeMismatchError extends ValidationError {\n override readonly code: string = \"POLICY_SCOPE_MISMATCH\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyScopeMismatchError\";\n }\n}\n\n/** The SDK was configured incorrectly (bad environment, missing credentials, …). */\nexport class ConfigurationError extends RequestError {\n override readonly code: string = \"INVALID_CONFIGURATION\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ConfigurationError\";\n }\n}\n\n/**\n * The operation requires additional multi-factor authentication. Catch this\n * class to handle all MFA flows, or the subclasses to branch per flow.\n */\nexport class MfaRequiredError extends RequestError {\n override readonly code: string = \"MFA_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaRequiredError\";\n }\n}\n\n/** The user must enroll in MFA before this operation can proceed. */\nexport class MfaEnrollmentRequiredError extends MfaRequiredError {\n override readonly code: string = \"MFA_ENROLLMENT_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaEnrollmentRequiredError\";\n }\n}\n\n/** The operation requires a fresh MFA step-up proof (retry with `X-Auth-Step-Up`). */\nexport class StepUpRequiredError extends MfaRequiredError {\n override readonly code: string = \"STEP_UP_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"StepUpRequiredError\";\n }\n}\n\n/** The operation requires a recent MFA-elevated session, not a one-use step-up proof. */\nexport class SessionElevationRequiredError extends MfaRequiredError {\n override readonly code: string = \"SESSION_ELEVATION_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"SessionElevationRequiredError\";\n }\n}\n\n/** The requested deletion would leave the account without an active MFA factor. */\nexport class MfaLastFactorRequiredError extends PreconditionFailedError {\n override readonly code: string = \"MFA_LAST_FACTOR_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaLastFactorRequiredError\";\n }\n}\n\n/** The reason an MFA challenge could not be completed. */\nexport type MfaVerificationFailureReason =\n | \"challenge-invalid\"\n | \"challenge-locked\"\n | \"otp-invalid\"\n | \"recovery-code-invalid\"\n | \"passkey-invalid\";\n\n/**\n * An expected MFA verification rejection. Callers should select their own\n * user-facing copy from `reason` instead of displaying the backend message.\n */\nexport class MfaVerificationError extends RequestError {\n override readonly code: string = \"MFA_VERIFICATION_FAILED\";\n\n constructor(\n message: string,\n readonly reason: MfaVerificationFailureReason,\n options?: PolyesterErrorOptions,\n ) {\n super(message, options);\n this.name = \"MfaVerificationError\";\n }\n}\n\n/**\n * The backend failed unexpectedly or returned a malformed response. Not\n * automatically retryable — the failure may recur and mutations may have\n * partially applied.\n */\nexport class InternalServerError extends PolyesterError {\n readonly code: string = \"INTERNAL_SERVER_ERROR\";\n readonly retryable = false;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"InternalServerError\";\n }\n}\n\nexport interface RealtimeErrorOptions extends PolyesterErrorOptions {\n /** Centrifugo protocol, disconnect, or unsubscribe code; 0 when none applies. */\n realtimeCode?: number;\n /** True when the realtime client is already retrying on its own. */\n retryable?: boolean;\n}\n\n/**\n * A realtime subscription failure reported by the server or the websocket\n * client. `retryable` errors (e.g. code 109, token expired) are being retried\n * automatically; only non-retryable ones end the subscription.\n */\nexport class RealtimeError extends PolyesterError {\n readonly code = \"REALTIME_ERROR\" as const;\n readonly retryable: boolean;\n readonly realtimeCode: number;\n\n constructor(message: string, options?: RealtimeErrorOptions) {\n super(message, options);\n this.name = \"RealtimeError\";\n this.realtimeCode = options?.realtimeCode ?? 0;\n this.retryable = options?.retryable ?? false;\n }\n}\n\n/**\n * Checks whether an error represents an aborted request (caller-initiated via\n * `AbortSignal`). Aborts are intentionally NOT part of the {@link PolyesterError}\n * tree and are never retryable.\n */\nexport function isAbortError(err: unknown): boolean {\n return err instanceof DOMException && err.name === \"AbortError\";\n}\n\n/** Checks whether an error is the `TimeoutError` raised by `AbortSignal.timeout()`. */\nexport function isTimeoutAbortError(err: unknown): boolean {\n return err instanceof DOMException && err.name === \"TimeoutError\";\n}\n\n/**\n * Checks whether an error is the `TypeError` a browser `fetch` raises when the\n * connection drops, either on the request or while reading the response body.\n */\nexport function isFetchNetworkError(err: unknown): boolean {\n return (\n err instanceof TypeError &&\n /^(failed to fetch|networkerror when attempting to fetch resource\\.?|load failed|network error)$/i.test(\n err.message,\n )\n );\n}\n\n/** Maps a plain HTTP status code onto the SDK error tree. */\nexport function errorFromHttpStatus(\n status: number,\n message: string,\n options?: RateLimitErrorOptions,\n): PolyesterError {\n if (status === 400 || status === 422) return new ValidationError(message, options);\n if (status === 401) return new AuthenticationError(message, options);\n if (status === 403) return new PermissionError(message, options);\n if (status === 404) return new ResourceNotFoundError(message, options);\n if (status === 408) return new TimeoutError(message, options);\n if (status === 409) return new AlreadyExistsError(message, options);\n if (status === 412) return new PreconditionFailedError(message, options);\n if (status === 413) return new RequestTooLargeError(message, options);\n if (status === 429) return new RateLimitError(message, options);\n if (status === 501) return new NotImplementedError(message, options);\n if (status === 502 || status === 503 || status === 504) {\n return new ServiceUnavailableError(message, options);\n }\n if (status >= 500) return new InternalServerError(message, options);\n if (status >= 400) return new RequestError(message, options);\n return new NetworkError(message, options);\n}\n\n/**\n * The bundler reported a UserOperation as definitively not executed, so nothing\n * moved on chain: `rejected` (dropped by the bundler, often for a fee below the\n * current price) or `failed` (its bundle transaction reverted). Submitting a\n * fresh operation is safe.\n */\nexport class UserOperationNotExecutedError extends RequestError {\n override readonly code: string = \"USER_OPERATION_NOT_EXECUTED\";\n readonly userOpHash: `0x${string}`;\n /** The bundler's `pimlico_getUserOperationStatus` result. */\n readonly bundlerStatus: \"rejected\" | \"failed\";\n\n constructor(\n message: string,\n userOpHash: `0x${string}`,\n bundlerStatus: \"rejected\" | \"failed\",\n options?: PolyesterErrorOptions,\n ) {\n super(message, options);\n this.name = \"UserOperationNotExecutedError\";\n this.userOpHash = userOpHash;\n this.bundlerStatus = bundlerStatus;\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { PolyesterErrorDetail } from \"./error-detail.js\";\nexport type { PolyesterErrorDetail } from \"./error-detail.js\";\nimport type { RateLimitDetail } from \"./rate-limit.schemas.js\";\n\n/**\n * Typed error hierarchy for the Polyester SDK.\n *\n * Every error raised by the SDK extends {@link PolyesterError}, which carries a\n * stable machine-readable `code` and a `retryable` flag. The tree splits on\n * retryability so callers can triage with a single `instanceof` check:\n *\n * ```\n * PolyesterError code retryable\n * ├── TransientError TRANSIENT_FAILURE true\n * │ ├── NetworkError NETWORK_ERROR true\n * │ ├── TimeoutError TIMEOUT true\n * │ ├── RateLimitError RATE_LIMITED true\n * │ ├── TimestampSkewError TIMESTAMP_SKEW true\n * │ │ └── RequestDeadlineExceededError REQUEST_DEADLINE_EXCEEDED\n * │ ├── ServiceUnavailableError SERVICE_UNAVAILABLE true\n * │ └── ClaimOutcomeUnknownError CLAIM_OUTCOME_UNKNOWN true\n * ├── RequestError REQUEST_FAILED false\n * │ ├── ValidationError VALIDATION_FAILED false\n * │ │ ├── StaleQuoteError STALE_QUOTE\n * │ │ ├── WithdrawDeadlineExpiredError WITHDRAW_DEADLINE_EXPIRED\n * │ │ └── PolicyScopeMismatchError POLICY_SCOPE_MISMATCH\n * │ ├── ResourceNotFoundError RESOURCE_NOT_FOUND false\n * │ ├── RequestTooLargeError REQUEST_TOO_LARGE false\n * │ ├── NotImplementedError NOT_IMPLEMENTED false\n * │ ├── AlreadyExistsError ALREADY_EXISTS false\n * │ │ └── UserOperationAlreadyKnownError USER_OPERATION_ALREADY_KNOWN\n * │ ├── PermissionError PERMISSION_DENIED false\n * │ ├── AuthenticationError UNAUTHENTICATED false\n * │ ├── PreconditionFailedError PRECONDITION_FAILED false\n * │ │ ├── RevisionConflictError REVISION_CONFLICT\n * │ │ ├── PolicyInUseError POLICY_IN_USE\n * │ │ ├── PolicyLockedError POLICY_LOCKED\n * │ │ ├── SubaccountChallengeInvalidError SUBACCOUNT_CHALLENGE_INVALID\n * │ │ └── MfaLastFactorRequiredError MFA_LAST_FACTOR_REQUIRED\n * │ ├── ConfigurationError INVALID_CONFIGURATION false\n * │ ├── MfaRequiredError MFA_REQUIRED false\n * │ │ ├── MfaEnrollmentRequiredError MFA_ENROLLMENT_REQUIRED\n * │ │ ├── StepUpRequiredError STEP_UP_REQUIRED\n * │ │ └── SessionElevationRequiredError SESSION_ELEVATION_REQUIRED\n * │ ├── MfaVerificationError MFA_VERIFICATION_FAILED false\n * │ ├── UserOperationSendTimeoutError USER_OPERATION_SEND_TIMEOUT false\n * │ ├── OutcomeUnknownError OUTCOME_UNKNOWN false\n * │ └── UserOperationNotExecutedError USER_OPERATION_NOT_EXECUTED false\n * ├── InternalServerError INTERNAL_SERVER_ERROR false\n * └── RealtimeError REALTIME_ERROR varies\n * ```\n *\n * Catalog errors (`CatalogLookupError`, `CatalogConversionError`, …) plug into\n * the same tree under `RequestError`/`ValidationError`.\n *\n * Errors mapped from RPC failures keep the original `ConnectError` as `cause`\n * and carry the response's `status` when available.\n *\n * @example\n * ```ts\n * try {\n * await client.orders.createSpotOrder(input);\n * } catch (err) {\n * if (err instanceof RateLimitError) await sleep(err.retryAfterMs ?? 1000);\n * else if (err instanceof TransientError) retry();\n * else if (err instanceof StepUpRequiredError) promptForMfa();\n * else throw err;\n * }\n * ```\n */\n\n/** Stable machine-readable codes carried by built-in SDK errors. */\nexport type PolyesterErrorCode =\n | \"TRANSIENT_FAILURE\"\n | \"NETWORK_ERROR\"\n | \"TIMEOUT\"\n | \"RATE_LIMITED\"\n | \"TIMESTAMP_SKEW\"\n | \"REQUEST_DEADLINE_EXCEEDED\"\n | \"SERVICE_UNAVAILABLE\"\n | \"CLAIM_OUTCOME_UNKNOWN\"\n | \"REQUEST_FAILED\"\n | \"VALIDATION_FAILED\"\n | \"STALE_QUOTE\"\n | \"WITHDRAW_DEADLINE_EXPIRED\"\n | \"RESOURCE_NOT_FOUND\"\n | \"REQUEST_TOO_LARGE\"\n | \"NOT_IMPLEMENTED\"\n | \"ALREADY_EXISTS\"\n | \"USER_OPERATION_ALREADY_KNOWN\"\n | \"USER_OPERATION_SEND_TIMEOUT\"\n | \"OUTCOME_UNKNOWN\"\n | \"USER_OPERATION_NOT_EXECUTED\"\n | \"PERMISSION_DENIED\"\n | \"UNAUTHENTICATED\"\n | \"PRECONDITION_FAILED\"\n | \"REVISION_CONFLICT\"\n | \"SUBACCOUNT_CHALLENGE_INVALID\"\n | \"POLICY_IN_USE\"\n | \"POLICY_LOCKED\"\n | \"POLICY_SCOPE_MISMATCH\"\n | \"INVALID_CONFIGURATION\"\n | \"MFA_REQUIRED\"\n | \"MFA_ENROLLMENT_REQUIRED\"\n | \"STEP_UP_REQUIRED\"\n | \"SESSION_ELEVATION_REQUIRED\"\n | \"MFA_LAST_FACTOR_REQUIRED\"\n | \"MFA_VERIFICATION_FAILED\"\n | \"INTERNAL_SERVER_ERROR\"\n | \"REALTIME_ERROR\"\n | \"CATALOG_LOOKUP_MISS\"\n | \"CATALOG_NOT_READY\"\n | \"CATALOG_CONVERSION_INVALID\"\n | \"CATALOG_VALIDATION_FAILED\";\n\nexport interface PolyesterErrorOptions {\n /** Underlying error, typically the original `ConnectError` for RPC failures. */\n cause?: unknown;\n /** Recognized structured backend rejection, decoded at the RPC boundary. */\n detail?: PolyesterErrorDetail;\n /** HTTP status of the failed response. */\n status?: number;\n}\n\nconst CONNECT_ERROR_PREFIX_RE = /^(?:\\[[a-z][a-z0-9_-]*]\\s*)+/i;\n\nexport function normalizeErrorMessage(message: string): string {\n return message.replace(CONNECT_ERROR_PREFIX_RE, \"\").trim();\n}\n\n/**\n * Base class for every error raised by the Polyester SDK.\n *\n * Check `retryable` (or `instanceof TransientError`) to decide whether the\n * same call can be safely retried, and switch on `code` for exhaustive,\n * minification-safe handling.\n */\nexport abstract class PolyesterError extends Error {\n /** Stable machine-readable error code, e.g. `\"RATE_LIMITED\"`. */\n abstract readonly code: string;\n /** Whether retrying the same operation may succeed. */\n abstract readonly retryable: boolean;\n readonly detail: PolyesterErrorDetail | undefined;\n /**\n * HTTP status of the failed response. For Connect errors that carry no raw\n * HTTP status, the Connect protocol's status for the error code.\n */\n readonly status: number | undefined;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(normalizeErrorMessage(message), options);\n this.name = \"PolyesterError\";\n const inherited = options?.cause instanceof PolyesterError ? options.cause : undefined;\n this.detail = options?.detail ?? inherited?.detail;\n this.status = options?.status ?? inherited?.status;\n }\n}\n\n/**\n * A transient failure — the request may never have reached the backend or the\n * backend was temporarily unable to serve it. Follow the operation's retry\n * contract: reuse requestId for idempotent mutations. For single-order creation,\n * reconcile by clientOrderId; reusing it returns a conflict rather than replay.\n */\nexport class TransientError extends PolyesterError {\n readonly code: string = \"TRANSIENT_FAILURE\";\n readonly retryable = true;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TransientError\";\n }\n}\n\n/** The request could not be sent or the connection failed mid-flight. */\nexport class NetworkError extends TransientError {\n override readonly code: string = \"NETWORK_ERROR\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"NetworkError\";\n }\n}\n\n/** The request timed out before the backend produced a response. */\nexport class TimeoutError extends TransientError {\n override readonly code: string = \"TIMEOUT\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TimeoutError\";\n }\n}\n\nexport interface RateLimitErrorOptions extends PolyesterErrorOptions {\n /** Suggested wait before retrying, when the backend provided one. */\n retryAfterMs?: number;\n /** Structured quota state attached to the rejection, when provided. */\n rateLimit?: RateLimitDetail;\n}\n\n/** The backend rejected the request due to rate limiting. */\nexport class RateLimitError extends TransientError {\n override readonly code: string = \"RATE_LIMITED\";\n /** Suggested wait before retrying, in milliseconds, when known. */\n readonly retryAfterMs?: number;\n /** Structured quota state attached to the rejection, when provided. */\n readonly rateLimit?: RateLimitDetail;\n\n constructor(message: string, options?: RateLimitErrorOptions) {\n super(message, options);\n this.name = \"RateLimitError\";\n this.retryAfterMs = options?.retryAfterMs;\n this.rateLimit = options?.rateLimit;\n }\n}\n\n/**\n * The API-key signature timestamp fell outside the backend's skew window, e.g.\n * because the request waited too long in the runtime's fetch queue during a\n * large concurrent burst, or the local clock drifted. Retrying the call signs\n * it again with a fresh timestamp; bound concurrency if it recurs.\n */\nexport class TimestampSkewError extends TransientError {\n override readonly code: string = \"TIMESTAMP_SKEW\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"TimestampSkewError\";\n }\n}\n\n/**\n * A signed order or trigger write passed authentication, but its receive window\n * (`X-API-TIMESTAMP` plus `recvWindow`) ended before it was sent on for admission.\n * Nothing changed and it is never an unknown outcome, so retrying the call, which\n * signs it again with a fresh timestamp, is safe.\n */\nexport class RequestDeadlineExceededError extends TimestampSkewError {\n override readonly code: string = \"REQUEST_DEADLINE_EXCEEDED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestDeadlineExceededError\";\n }\n}\n\n/** The backend is temporarily unavailable (e.g. overloaded or restarting). */\nexport class ServiceUnavailableError extends TransientError {\n override readonly code: string = \"SERVICE_UNAVAILABLE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ServiceUnavailableError\";\n }\n}\n\nexport interface ClaimOutcomeUnknownErrorOptions extends PolyesterErrorOptions {\n /** Claim the error concerns, when the backend named it. */\n claimId?: string;\n}\n\n/**\n * Today's daily claim is recorded and its payout was submitted, but its result could not be\n * confirmed. Treat it as a pending claim, not a failure: the claim is never paid twice, so poll\n * `claims.getDailyClaimStatus` until `claimId` matches and the claim is `claimed`, or retry\n * `claims.claimDailyReward` to get its current state.\n */\nexport class ClaimOutcomeUnknownError extends TransientError {\n override readonly code: string = \"CLAIM_OUTCOME_UNKNOWN\";\n /** Claim the error concerns, when the backend named it. */\n readonly claimId: string | undefined;\n\n constructor(message: string, options?: ClaimOutcomeUnknownErrorOptions) {\n super(message, options);\n this.name = \"ClaimOutcomeUnknownError\";\n this.claimId = options?.claimId;\n }\n}\n\n/**\n * The request itself was rejected — retrying the identical call will fail the\n * same way. Fix the input, authentication, or permissions first.\n */\nexport class RequestError extends PolyesterError {\n readonly code: string = \"REQUEST_FAILED\";\n readonly retryable = false;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestError\";\n }\n}\n\n/** The request input failed validation (client- or server-side). */\nexport class ValidationError extends RequestError {\n override readonly code: string = \"VALIDATION_FAILED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ValidationError\";\n }\n}\n\n/** The submitted client reference quote exceeded the market's configured drift limit. */\nexport class StaleQuoteError extends ValidationError {\n override readonly code = \"STALE_QUOTE\" as const;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"StaleQuoteError\";\n }\n}\n\n/**\n * The prepared withdraw's signed deadline has passed, so the backend would\n * reject it. Prepare (and sign) the withdraw again.\n *\n * Thrown by `submit` before sending once the deadline has passed, and when the\n * backend rejects the deadline as expired: one that lapsed in flight, or one\n * signed from a device clock running behind the server's.\n */\nexport class WithdrawDeadlineExpiredError extends ValidationError {\n override readonly code: string = \"WITHDRAW_DEADLINE_EXPIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"WithdrawDeadlineExpiredError\";\n }\n}\n\n/**\n * The request body was over the endpoint's size limit (HTTP 413). The limit is\n * fixed per endpoint, so the same request fails again; send a smaller one.\n */\nexport class RequestTooLargeError extends RequestError {\n override readonly code: string = \"REQUEST_TOO_LARGE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RequestTooLargeError\";\n }\n}\n\n/** The requested resource does not exist (or is not visible to the caller). */\nexport class ResourceNotFoundError extends RequestError {\n override readonly code: string = \"RESOURCE_NOT_FOUND\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ResourceNotFoundError\";\n }\n}\n\n/** The backend does not implement the requested operation (HTTP 501 / Connect `unimplemented`). */\nexport class NotImplementedError extends RequestError {\n override readonly code: string = \"NOT_IMPLEMENTED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"NotImplementedError\";\n }\n}\n\n/** The resource already exists (e.g. a duplicate `clientOrderId`). */\nexport class AlreadyExistsError extends RequestError {\n override readonly code: string = \"ALREADY_EXISTS\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"AlreadyExistsError\";\n }\n}\n\n/**\n * The bundler already holds this exact UserOperation (it answered \"Already\n * known\"), so the earlier submission is still pending. Wait on `userOpHash`\n * instead of signing again; a new operation would execute a second time.\n */\nexport class UserOperationAlreadyKnownError extends AlreadyExistsError {\n override readonly code: string = \"USER_OPERATION_ALREADY_KNOWN\";\n readonly userOpHash: `0x${string}`;\n\n constructor(message: string, userOpHash: `0x${string}`, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"UserOperationAlreadyKnownError\";\n this.userOpHash = userOpHash;\n }\n}\n\n/**\n * `eth_sendUserOperation` timed out after the UserOperation was signed. The\n * bundler may still have accepted it, so the outcome is unknown rather than\n * rejected. Wait on `userOpHash` instead of signing again; a new operation\n * could execute a second time. Not retryable for the same reason.\n */\nexport class UserOperationSendTimeoutError extends RequestError {\n override readonly code: string = \"USER_OPERATION_SEND_TIMEOUT\";\n readonly userOpHash: `0x${string}`;\n\n constructor(message: string, userOpHash: `0x${string}`, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"UserOperationSendTimeoutError\";\n this.userOpHash = userOpHash;\n }\n}\n\n/**\n * An order or trigger change was sent but not confirmed in time, so it may\n * still apply. Not retryable: read the order by its client order ID, or list\n * triggers by client trigger ID, before sending it again. `detail.code` names\n * the operation, e.g. `ORDER_CREATE_OUTCOME_UNKNOWN`.\n */\nexport class OutcomeUnknownError extends RequestError {\n override readonly code: string = \"OUTCOME_UNKNOWN\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"OutcomeUnknownError\";\n }\n}\n\n/** The caller is authenticated but not allowed to perform this operation. */\nexport class PermissionError extends RequestError {\n override readonly code: string = \"PERMISSION_DENIED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PermissionError\";\n }\n}\n\n/** The caller is not authenticated (missing, expired, or invalid credentials). */\nexport class AuthenticationError extends RequestError {\n override readonly code: string = \"UNAUTHENTICATED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"AuthenticationError\";\n }\n}\n\n/** The system is not in a state that allows this operation (e.g. insufficient balance). */\nexport class PreconditionFailedError extends RequestError {\n override readonly code: string = \"PRECONDITION_FAILED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PreconditionFailedError\";\n }\n}\n\n/**\n * The resource changed after it was read, so the submitted expected revision\n * is stale. Refetch and let the caller reconcile; do not blindly retry.\n */\nexport class RevisionConflictError extends PreconditionFailedError {\n override readonly code: string = \"REVISION_CONFLICT\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"RevisionConflictError\";\n }\n}\n\n/**\n * The subaccount authorization is expired, replaced by a newer challenge, already\n * consumed, or has an invalid signature. Request a fresh challenge via\n * `subaccounts.createChallenge`. Temporary verification failures surface as\n * `ServiceUnavailableError` instead; retry those with the same signed challenge.\n */\nexport class SubaccountChallengeInvalidError extends PreconditionFailedError {\n override readonly code: string = \"SUBACCOUNT_CHALLENGE_INVALID\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"SubaccountChallengeInvalidError\";\n }\n}\n\n/** The policy cannot be removed while accounts or API keys still use it. */\nexport class PolicyInUseError extends PreconditionFailedError {\n override readonly code: string = \"POLICY_IN_USE\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyInUseError\";\n }\n}\n\n/** The policy is locked against the requested mutation. */\nexport class PolicyLockedError extends PreconditionFailedError {\n override readonly code: string = \"POLICY_LOCKED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyLockedError\";\n }\n}\n\n/** The policy does not belong to the account scope targeted by the request. */\nexport class PolicyScopeMismatchError extends ValidationError {\n override readonly code: string = \"POLICY_SCOPE_MISMATCH\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"PolicyScopeMismatchError\";\n }\n}\n\n/** The SDK was configured incorrectly (bad environment, missing credentials, …). */\nexport class ConfigurationError extends RequestError {\n override readonly code: string = \"INVALID_CONFIGURATION\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"ConfigurationError\";\n }\n}\n\n/**\n * The operation requires additional multi-factor authentication. Catch this\n * class to handle all MFA flows, or the subclasses to branch per flow.\n */\nexport class MfaRequiredError extends RequestError {\n override readonly code: string = \"MFA_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaRequiredError\";\n }\n}\n\n/** The user must enroll in MFA before this operation can proceed. */\nexport class MfaEnrollmentRequiredError extends MfaRequiredError {\n override readonly code: string = \"MFA_ENROLLMENT_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaEnrollmentRequiredError\";\n }\n}\n\n/** The operation requires a fresh MFA step-up proof (retry with `X-Auth-Step-Up`). */\nexport class StepUpRequiredError extends MfaRequiredError {\n override readonly code: string = \"STEP_UP_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"StepUpRequiredError\";\n }\n}\n\n/** The operation requires a recent MFA-elevated session, not a one-use step-up proof. */\nexport class SessionElevationRequiredError extends MfaRequiredError {\n override readonly code: string = \"SESSION_ELEVATION_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"SessionElevationRequiredError\";\n }\n}\n\n/** The requested deletion would leave the account without an active MFA factor. */\nexport class MfaLastFactorRequiredError extends PreconditionFailedError {\n override readonly code: string = \"MFA_LAST_FACTOR_REQUIRED\";\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"MfaLastFactorRequiredError\";\n }\n}\n\n/** The reason an MFA challenge could not be completed. */\nexport type MfaVerificationFailureReason =\n | \"challenge-invalid\"\n | \"challenge-locked\"\n | \"otp-invalid\"\n | \"recovery-code-invalid\"\n | \"passkey-invalid\";\n\n/**\n * An expected MFA verification rejection. Callers should select their own\n * user-facing copy from `reason` instead of displaying the backend message.\n */\nexport class MfaVerificationError extends RequestError {\n override readonly code: string = \"MFA_VERIFICATION_FAILED\";\n\n constructor(\n message: string,\n readonly reason: MfaVerificationFailureReason,\n options?: PolyesterErrorOptions,\n ) {\n super(message, options);\n this.name = \"MfaVerificationError\";\n }\n}\n\n/**\n * The backend failed unexpectedly or returned a malformed response. Not\n * automatically retryable — the failure may recur and mutations may have\n * partially applied.\n */\nexport class InternalServerError extends PolyesterError {\n readonly code: string = \"INTERNAL_SERVER_ERROR\";\n readonly retryable = false;\n\n constructor(message: string, options?: PolyesterErrorOptions) {\n super(message, options);\n this.name = \"InternalServerError\";\n }\n}\n\nexport interface RealtimeErrorOptions extends PolyesterErrorOptions {\n /** Centrifugo protocol, disconnect, or unsubscribe code; 0 when none applies. */\n realtimeCode?: number;\n /** True when the realtime client is already retrying on its own. */\n retryable?: boolean;\n}\n\n/**\n * A realtime subscription failure reported by the server or the websocket\n * client. `retryable` errors (e.g. code 109, token expired) are being retried\n * automatically; only non-retryable ones end the subscription.\n */\nexport class RealtimeError extends PolyesterError {\n readonly code = \"REALTIME_ERROR\" as const;\n readonly retryable: boolean;\n readonly realtimeCode: number;\n\n constructor(message: string, options?: RealtimeErrorOptions) {\n super(message, options);\n this.name = \"RealtimeError\";\n this.realtimeCode = options?.realtimeCode ?? 0;\n this.retryable = options?.retryable ?? false;\n }\n}\n\n/**\n * Checks whether an error represents an aborted request (caller-initiated via\n * `AbortSignal`). Aborts are intentionally NOT part of the {@link PolyesterError}\n * tree and are never retryable.\n */\nexport function isAbortError(err: unknown): boolean {\n return err instanceof DOMException && err.name === \"AbortError\";\n}\n\n/** Checks whether an error is the `TimeoutError` raised by `AbortSignal.timeout()`. */\nexport function isTimeoutAbortError(err: unknown): boolean {\n return err instanceof DOMException && err.name === \"TimeoutError\";\n}\n\n/**\n * Checks whether an error is the `TypeError` a browser `fetch` raises when the\n * connection drops, either on the request or while reading the response body.\n */\nexport function isFetchNetworkError(err: unknown): boolean {\n return (\n err instanceof TypeError &&\n /^(failed to fetch|networkerror when attempting to fetch resource\\.?|load failed|network error)$/i.test(\n err.message,\n )\n );\n}\n\n/** Maps a plain HTTP status code onto the SDK error tree. */\nexport function errorFromHttpStatus(\n status: number,\n message: string,\n options?: RateLimitErrorOptions,\n): PolyesterError {\n if (status === 400 || status === 422) return new ValidationError(message, options);\n if (status === 401) return new AuthenticationError(message, options);\n if (status === 403) return new PermissionError(message, options);\n if (status === 404) return new ResourceNotFoundError(message, options);\n if (status === 408) return new TimeoutError(message, options);\n if (status === 409) return new AlreadyExistsError(message, options);\n if (status === 412) return new PreconditionFailedError(message, options);\n if (status === 413) return new RequestTooLargeError(message, options);\n if (status === 429) return new RateLimitError(message, options);\n if (status === 501) return new NotImplementedError(message, options);\n if (status === 502 || status === 503 || status === 504) {\n return new ServiceUnavailableError(message, options);\n }\n if (status >= 500) return new InternalServerError(message, options);\n if (status >= 400) return new RequestError(message, options);\n return new NetworkError(message, options);\n}\n\n/**\n * The bundler reported a UserOperation as definitively not executed, so nothing\n * moved on chain: `rejected` (dropped by the bundler, often for a fee below the\n * current price) or `failed` (its bundle transaction reverted). Submitting a\n * fresh operation is safe.\n */\nexport class UserOperationNotExecutedError extends RequestError {\n override readonly code: string = \"USER_OPERATION_NOT_EXECUTED\";\n readonly userOpHash: `0x${string}`;\n /** The bundler's `pimlico_getUserOperationStatus` result. */\n readonly bundlerStatus: \"rejected\" | \"failed\";\n\n constructor(\n message: string,\n userOpHash: `0x${string}`,\n bundlerStatus: \"rejected\" | \"failed\",\n options?: PolyesterErrorOptions,\n ) {\n super(message, options);\n this.name = \"UserOperationNotExecutedError\";\n this.userOpHash = userOpHash;\n this.bundlerStatus = bundlerStatus;\n }\n}\n"],"mappings":"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"}
|
|
@@ -2,7 +2,13 @@ import "../gen/ledger/v1/catalog_pb.js";
|
|
|
2
2
|
//#region src/shared/ledger-codes.d.ts
|
|
3
3
|
declare const ACCOUNT_CODE_VALUES: readonly ["funding", "trading"];
|
|
4
4
|
type AccountCodeValue = (typeof ACCOUNT_CODE_VALUES)[number];
|
|
5
|
-
declare const TRANSFER_CODE_VALUES: readonly ["deposit", "withdraw", "maker_fee", "taker_fee", "internal_transfer", "trade_base", "trade_quote", "rebate", "funding_to_trading", "trading_to_funding", "trading_withdraw_reserve", "funding_user_transfer", "trading_withdraw_request_fee"];
|
|
5
|
+
declare const TRANSFER_CODE_VALUES: readonly ["deposit", "withdraw", "maker_fee", "taker_fee", "internal_transfer", "trade_base", "trade_quote", "rebate", "funding_to_trading", "trading_to_funding", "trading_withdraw_reserve", "funding_user_transfer", "trading_withdraw_request_fee", "trading_withdraw_fee_leg", "quickswap_polyester_fee", "quickswap_broker_fee", "quickswap_affiliate_fee", "fee_sweep", "fee_refill", "system_adjustment", "withdraw_failed"];
|
|
6
|
+
/**
|
|
7
|
+
* Ledger transfer type. `system_adjustment` can credit or debit the account (a seeding credit
|
|
8
|
+
* or a correction), so read the row's `isDebit` for its direction. `withdraw_failed` is funds that
|
|
9
|
+
* left the account for a withdrawal that was rejected or failed to execute; its fee is not
|
|
10
|
+
* refunded.
|
|
11
|
+
*/
|
|
6
12
|
type TransferCodeValue = (typeof TRANSFER_CODE_VALUES)[number];
|
|
7
13
|
//#endregion
|
|
8
14
|
export { ACCOUNT_CODE_VALUES, AccountCodeValue, TRANSFER_CODE_VALUES, TransferCodeValue };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ledger-codes.d.ts","names":[],"sources":["../../src/shared/ledger-codes.ts"],"mappings":";;cAGa;KACD,2BAA2B;cAE1B
|
|
1
|
+
{"version":3,"file":"ledger-codes.d.ts","names":[],"sources":["../../src/shared/ledger-codes.ts"],"mappings":";;cAGa;KACD,2BAA2B;cAE1B;;;;;;;KA6BD,4BAA4B"}
|
|
@@ -14,7 +14,15 @@ const TRANSFER_CODE_VALUES = [
|
|
|
14
14
|
"trading_to_funding",
|
|
15
15
|
"trading_withdraw_reserve",
|
|
16
16
|
"funding_user_transfer",
|
|
17
|
-
"trading_withdraw_request_fee"
|
|
17
|
+
"trading_withdraw_request_fee",
|
|
18
|
+
"trading_withdraw_fee_leg",
|
|
19
|
+
"quickswap_polyester_fee",
|
|
20
|
+
"quickswap_broker_fee",
|
|
21
|
+
"quickswap_affiliate_fee",
|
|
22
|
+
"fee_sweep",
|
|
23
|
+
"fee_refill",
|
|
24
|
+
"system_adjustment",
|
|
25
|
+
"withdraw_failed"
|
|
18
26
|
];
|
|
19
27
|
const AccountCodeCodec = {
|
|
20
28
|
inputToProto: {
|
|
@@ -41,7 +49,15 @@ const TransferCodeCodec = {
|
|
|
41
49
|
trading_to_funding: 1061,
|
|
42
50
|
trading_withdraw_reserve: 1062,
|
|
43
51
|
funding_user_transfer: 1063,
|
|
44
|
-
trading_withdraw_request_fee: 1065
|
|
52
|
+
trading_withdraw_request_fee: 1065,
|
|
53
|
+
trading_withdraw_fee_leg: 1066,
|
|
54
|
+
quickswap_polyester_fee: 1067,
|
|
55
|
+
quickswap_broker_fee: 1068,
|
|
56
|
+
quickswap_affiliate_fee: 1069,
|
|
57
|
+
fee_sweep: 1072,
|
|
58
|
+
fee_refill: 1073,
|
|
59
|
+
system_adjustment: 1074,
|
|
60
|
+
withdraw_failed: 1075
|
|
45
61
|
},
|
|
46
62
|
protoToOutput: {
|
|
47
63
|
[0]: "unspecified",
|
|
@@ -57,7 +73,15 @@ const TransferCodeCodec = {
|
|
|
57
73
|
[1061]: "trading_to_funding",
|
|
58
74
|
[1062]: "trading_withdraw_reserve",
|
|
59
75
|
[1063]: "funding_user_transfer",
|
|
60
|
-
[1065]: "trading_withdraw_request_fee"
|
|
76
|
+
[1065]: "trading_withdraw_request_fee",
|
|
77
|
+
[1066]: "trading_withdraw_fee_leg",
|
|
78
|
+
[1067]: "quickswap_polyester_fee",
|
|
79
|
+
[1068]: "quickswap_broker_fee",
|
|
80
|
+
[1069]: "quickswap_affiliate_fee",
|
|
81
|
+
[1072]: "fee_sweep",
|
|
82
|
+
[1073]: "fee_refill",
|
|
83
|
+
[1074]: "system_adjustment",
|
|
84
|
+
[1075]: "withdraw_failed"
|
|
61
85
|
}
|
|
62
86
|
};
|
|
63
87
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ledger-codes.js","names":[],"sources":["../../src/shared/ledger-codes.ts"],"sourcesContent":["import { AccountCode, TransferCode } from \"../gen/ledger/v1/catalog_pb.js\";\nimport type { InputToProto, ProtoToOutput } from \"../utils/types.js\";\n\nexport const ACCOUNT_CODE_VALUES = [\"funding\", \"trading\"] as const;\nexport type AccountCodeValue = (typeof ACCOUNT_CODE_VALUES)[number];\n\nexport const TRANSFER_CODE_VALUES = [\n \"deposit\",\n \"withdraw\",\n \"maker_fee\",\n \"taker_fee\",\n \"internal_transfer\",\n \"trade_base\",\n \"trade_quote\",\n \"rebate\",\n \"funding_to_trading\",\n \"trading_to_funding\",\n \"trading_withdraw_reserve\",\n \"funding_user_transfer\",\n \"trading_withdraw_request_fee\",\n] as const;\nexport type TransferCodeValue = (typeof TRANSFER_CODE_VALUES)[number];\n\nexport const AccountCodeCodec = {\n inputToProto: {\n funding: AccountCode.FUNDING,\n trading: AccountCode.TRADING,\n } satisfies InputToProto<AccountCodeValue, AccountCode>,\n protoToOutput: {\n [AccountCode.ACCOUNT_CODE_UNSPECIFIED]: \"unspecified\",\n [AccountCode.FUNDING]: \"funding\",\n [AccountCode.TRADING]: \"trading\",\n } satisfies ProtoToOutput<AccountCode, AccountCodeValue>,\n} as const;\n\nexport const TransferCodeCodec = {\n inputToProto: {\n deposit: TransferCode.DEPOSIT,\n withdraw: TransferCode.WITHDRAW,\n maker_fee: TransferCode.MAKER_FEE,\n taker_fee: TransferCode.TAKER_FEE,\n internal_transfer: TransferCode.INTERNAL_TRANSFER,\n trade_base: TransferCode.TRADE_BASE,\n trade_quote: TransferCode.TRADE_QUOTE,\n rebate: TransferCode.REBATE,\n funding_to_trading: TransferCode.FUNDING_TO_TRADING,\n trading_to_funding: TransferCode.TRADING_TO_FUNDING,\n trading_withdraw_reserve: TransferCode.TRADING_WITHDRAW_RESERVE,\n funding_user_transfer: TransferCode.FUNDING_USER_TRANSFER,\n trading_withdraw_request_fee: TransferCode.TRADING_WITHDRAW_REQUEST_FEE,\n } satisfies InputToProto<TransferCodeValue, TransferCode>,\n protoToOutput: {\n [TransferCode.TRANSFER_CODE_UNSPECIFIED]: \"unspecified\",\n [TransferCode.DEPOSIT]: \"deposit\",\n [TransferCode.WITHDRAW]: \"withdraw\",\n [TransferCode.MAKER_FEE]: \"maker_fee\",\n [TransferCode.TAKER_FEE]: \"taker_fee\",\n [TransferCode.INTERNAL_TRANSFER]: \"internal_transfer\",\n [TransferCode.TRADE_BASE]: \"trade_base\",\n [TransferCode.TRADE_QUOTE]: \"trade_quote\",\n [TransferCode.REBATE]: \"rebate\",\n [TransferCode.FUNDING_TO_TRADING]: \"funding_to_trading\",\n [TransferCode.TRADING_TO_FUNDING]: \"trading_to_funding\",\n [TransferCode.TRADING_WITHDRAW_RESERVE]: \"trading_withdraw_reserve\",\n [TransferCode.FUNDING_USER_TRANSFER]: \"funding_user_transfer\",\n [TransferCode.TRADING_WITHDRAW_REQUEST_FEE]: \"trading_withdraw_request_fee\",\n } satisfies ProtoToOutput<TransferCode, TransferCodeValue>,\n} as const;\n"],"mappings":";;AAGA,MAAa,sBAAsB,CAAC,WAAW,SAAS;AAGxD,MAAa,uBAAuB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;
|
|
1
|
+
{"version":3,"file":"ledger-codes.js","names":[],"sources":["../../src/shared/ledger-codes.ts"],"sourcesContent":["import { AccountCode, TransferCode } from \"../gen/ledger/v1/catalog_pb.js\";\nimport type { InputToProto, ProtoToOutput } from \"../utils/types.js\";\n\nexport const ACCOUNT_CODE_VALUES = [\"funding\", \"trading\"] as const;\nexport type AccountCodeValue = (typeof ACCOUNT_CODE_VALUES)[number];\n\nexport const TRANSFER_CODE_VALUES = [\n \"deposit\",\n \"withdraw\",\n \"maker_fee\",\n \"taker_fee\",\n \"internal_transfer\",\n \"trade_base\",\n \"trade_quote\",\n \"rebate\",\n \"funding_to_trading\",\n \"trading_to_funding\",\n \"trading_withdraw_reserve\",\n \"funding_user_transfer\",\n \"trading_withdraw_request_fee\",\n \"trading_withdraw_fee_leg\",\n \"quickswap_polyester_fee\",\n \"quickswap_broker_fee\",\n \"quickswap_affiliate_fee\",\n \"fee_sweep\",\n \"fee_refill\",\n \"system_adjustment\",\n \"withdraw_failed\",\n] as const;\n/**\n * Ledger transfer type. `system_adjustment` can credit or debit the account (a seeding credit\n * or a correction), so read the row's `isDebit` for its direction. `withdraw_failed` is funds that\n * left the account for a withdrawal that was rejected or failed to execute; its fee is not\n * refunded.\n */\nexport type TransferCodeValue = (typeof TRANSFER_CODE_VALUES)[number];\n\nexport const AccountCodeCodec = {\n inputToProto: {\n funding: AccountCode.FUNDING,\n trading: AccountCode.TRADING,\n } satisfies InputToProto<AccountCodeValue, AccountCode>,\n protoToOutput: {\n [AccountCode.ACCOUNT_CODE_UNSPECIFIED]: \"unspecified\",\n [AccountCode.FUNDING]: \"funding\",\n [AccountCode.TRADING]: \"trading\",\n } satisfies ProtoToOutput<AccountCode, AccountCodeValue>,\n} as const;\n\nexport const TransferCodeCodec = {\n inputToProto: {\n deposit: TransferCode.DEPOSIT,\n withdraw: TransferCode.WITHDRAW,\n maker_fee: TransferCode.MAKER_FEE,\n taker_fee: TransferCode.TAKER_FEE,\n internal_transfer: TransferCode.INTERNAL_TRANSFER,\n trade_base: TransferCode.TRADE_BASE,\n trade_quote: TransferCode.TRADE_QUOTE,\n rebate: TransferCode.REBATE,\n funding_to_trading: TransferCode.FUNDING_TO_TRADING,\n trading_to_funding: TransferCode.TRADING_TO_FUNDING,\n trading_withdraw_reserve: TransferCode.TRADING_WITHDRAW_RESERVE,\n funding_user_transfer: TransferCode.FUNDING_USER_TRANSFER,\n trading_withdraw_request_fee: TransferCode.TRADING_WITHDRAW_REQUEST_FEE,\n trading_withdraw_fee_leg: TransferCode.TRADING_WITHDRAW_FEE_LEG,\n quickswap_polyester_fee: TransferCode.QUICKSWAP_POLYESTER_FEE,\n quickswap_broker_fee: TransferCode.QUICKSWAP_BROKER_FEE,\n quickswap_affiliate_fee: TransferCode.QUICKSWAP_AFFILIATE_FEE,\n fee_sweep: TransferCode.FEE_SWEEP,\n fee_refill: TransferCode.FEE_REFILL,\n system_adjustment: TransferCode.SYSTEM_ADJUSTMENT,\n withdraw_failed: TransferCode.WITHDRAW_FAILED,\n } satisfies InputToProto<TransferCodeValue, TransferCode>,\n protoToOutput: {\n [TransferCode.TRANSFER_CODE_UNSPECIFIED]: \"unspecified\",\n [TransferCode.DEPOSIT]: \"deposit\",\n [TransferCode.WITHDRAW]: \"withdraw\",\n [TransferCode.MAKER_FEE]: \"maker_fee\",\n [TransferCode.TAKER_FEE]: \"taker_fee\",\n [TransferCode.INTERNAL_TRANSFER]: \"internal_transfer\",\n [TransferCode.TRADE_BASE]: \"trade_base\",\n [TransferCode.TRADE_QUOTE]: \"trade_quote\",\n [TransferCode.REBATE]: \"rebate\",\n [TransferCode.FUNDING_TO_TRADING]: \"funding_to_trading\",\n [TransferCode.TRADING_TO_FUNDING]: \"trading_to_funding\",\n [TransferCode.TRADING_WITHDRAW_RESERVE]: \"trading_withdraw_reserve\",\n [TransferCode.FUNDING_USER_TRANSFER]: \"funding_user_transfer\",\n [TransferCode.TRADING_WITHDRAW_REQUEST_FEE]: \"trading_withdraw_request_fee\",\n [TransferCode.TRADING_WITHDRAW_FEE_LEG]: \"trading_withdraw_fee_leg\",\n [TransferCode.QUICKSWAP_POLYESTER_FEE]: \"quickswap_polyester_fee\",\n [TransferCode.QUICKSWAP_BROKER_FEE]: \"quickswap_broker_fee\",\n [TransferCode.QUICKSWAP_AFFILIATE_FEE]: \"quickswap_affiliate_fee\",\n [TransferCode.FEE_SWEEP]: \"fee_sweep\",\n [TransferCode.FEE_REFILL]: \"fee_refill\",\n [TransferCode.SYSTEM_ADJUSTMENT]: \"system_adjustment\",\n [TransferCode.WITHDRAW_FAILED]: \"withdraw_failed\",\n } satisfies ProtoToOutput<TransferCode, TransferCodeValue>,\n} as const;\n"],"mappings":";;AAGA,MAAa,sBAAsB,CAAC,WAAW,SAAS;AAGxD,MAAa,uBAAuB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;AASA,MAAa,mBAAmB;CAC5B,cAAc;EACV,SAAA;EACA,SAAA;CACJ;CACA,eAAe;GAC6B,IAAA;GACjB,MAAA;GACA,MAAA;CAC3B;AACJ;AAEA,MAAa,oBAAoB;CAC7B,cAAc;EACV,SAAA;EACA,UAAA;EACA,WAAA;EACA,WAAA;EACA,mBAAA;EACA,YAAA;EACA,aAAA;EACA,QAAA;EACA,oBAAA;EACA,oBAAA;EACA,0BAAA;EACA,uBAAA;EACA,8BAAA;EACA,0BAAA;EACA,yBAAA;EACA,sBAAA;EACA,yBAAA;EACA,WAAA;EACA,YAAA;EACA,mBAAA;EACA,iBAAA;CACJ;CACA,eAAe;GAC+B,IAAA;GAClB,MAAA;GACC,OAAA;GACC,OAAA;GACA,OAAA;GACQ,OAAA;GACP,OAAA;GACC,OAAA;GACL,OAAA;GACY,OAAA;GACA,OAAA;GACM,OAAA;GACH,OAAA;GACO,OAAA;GACJ,OAAA;GACD,OAAA;GACH,OAAA;GACG,OAAA;GACd,OAAA;GACC,OAAA;GACO,OAAA;GACF,OAAA;CACpC;AACJ"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as v from "valibot";
|
|
2
2
|
//#region src/shared/rate-limit.schemas.d.ts
|
|
3
3
|
declare const RATE_LIMIT_FAILURE_REASON_VALUES: readonly ["unspecified", "quota_exceeded", "authority_unavailable"];
|
|
4
|
-
declare const RATE_LIMIT_POLICY_CLASS_VALUES: readonly ["unspecified", "auth_public", "trading_place", "trading_cancel", "trading_read", "account_admin", "public_read", "account_security", "deposit_create", "internal_transfer", "withdraw_submit", "withdraw_validate", "guard_sign", "social_provider"];
|
|
4
|
+
declare const RATE_LIMIT_POLICY_CLASS_VALUES: readonly ["unspecified", "auth_public", "trading_place", "trading_cancel", "trading_read", "account_admin", "public_read", "account_security", "deposit_create", "internal_transfer", "withdraw_submit", "withdraw_validate", "guard_sign", "social_provider", "assistant_message", "assistant_control", "assistant_read"];
|
|
5
5
|
declare const RATE_LIMIT_SCOPE_VALUES: readonly ["unspecified", "client_ip", "api_key", "account", "subaccount", "connection", "service", "region", "symbol", "auth_subject"];
|
|
6
6
|
declare const RATE_LIMIT_REFILL_MODEL_VALUES: readonly ["unspecified", "continuous", "fixed_window", "rolling_window"];
|
|
7
7
|
/** Machine-readable reason for a rate-limit rejection. */
|
|
@@ -20,7 +20,7 @@ declare const RateLimitDetailSchema: v.ObjectSchema<{
|
|
|
20
20
|
readonly retryAfterMs: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BigintSchema<undefined>, undefined>, v.TransformAction<bigint | undefined, string | undefined>]>;
|
|
21
21
|
readonly policyVersion: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BigintSchema<undefined>, undefined>, v.TransformAction<bigint | undefined, string | undefined>]>;
|
|
22
22
|
readonly operationId: v.StringSchema<undefined>;
|
|
23
|
-
readonly policyClass: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, "unspecified" | "auth_public" | "trading_place" | "trading_cancel" | "trading_read" | "account_admin" | "public_read" | "account_security" | "deposit_create" | "internal_transfer" | "withdraw_submit" | "withdraw_validate" | "guard_sign" | "social_provider">]>;
|
|
23
|
+
readonly policyClass: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, "unspecified" | "auth_public" | "trading_place" | "trading_cancel" | "trading_read" | "account_admin" | "public_read" | "account_security" | "deposit_create" | "internal_transfer" | "withdraw_submit" | "withdraw_validate" | "guard_sign" | "social_provider" | "assistant_message" | "assistant_control" | "assistant_read">]>;
|
|
24
24
|
readonly scope: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, "symbol" | "unspecified" | "subaccount" | "client_ip" | "api_key" | "account" | "connection" | "service" | "region" | "auth_subject">]>;
|
|
25
25
|
readonly refillModel: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, "unspecified" | "continuous" | "fixed_window" | "rolling_window">]>;
|
|
26
26
|
}, undefined>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rate-limit.schemas.d.ts","names":[],"sources":["../../src/shared/rate-limit.schemas.ts"],"mappings":";;cAMM;cAMA;
|
|
1
|
+
{"version":3,"file":"rate-limit.schemas.d.ts","names":[],"sources":["../../src/shared/rate-limit.schemas.ts"],"mappings":";;cAMM;cAMA;cAoBA;cAaA;;KAQM,iCAAiC;;KAEjC,+BAA+B;;KAE/B,yBAAyB;;KAEzB,+BAA+B;;cAyD9B,uBAAqB,EAAA;;;;;;;;;;;;KAatB,kBAAkB,EAAE,mBAAmB"}
|
|
@@ -28,7 +28,10 @@ const RateLimitDetailSchema = v.object({
|
|
|
28
28
|
[10]: "withdraw_submit",
|
|
29
29
|
[11]: "withdraw_validate",
|
|
30
30
|
[12]: "guard_sign",
|
|
31
|
-
[13]: "social_provider"
|
|
31
|
+
[13]: "social_provider",
|
|
32
|
+
[14]: "assistant_message",
|
|
33
|
+
[15]: "assistant_control",
|
|
34
|
+
[16]: "assistant_read"
|
|
32
35
|
} }.protoToOutput),
|
|
33
36
|
scope: enumLabelSchema({ protoToOutput: {
|
|
34
37
|
[0]: "unspecified",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rate-limit.schemas.js","names":[],"sources":["../../src/shared/rate-limit.schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport * as Proto from \"../gen/polyester/ratelimit/v1/types_pb.js\";\nimport type { ProtoToOutput } from \"../utils/types.js\";\nimport { enumLabelSchema } from \"./proto-enum-codec.js\";\nimport { OptionalBigIntStringSchema } from \"./schemas.js\";\n\nconst RATE_LIMIT_FAILURE_REASON_VALUES = [\n \"unspecified\",\n \"quota_exceeded\",\n \"authority_unavailable\",\n] as const;\n\nconst RATE_LIMIT_POLICY_CLASS_VALUES = [\n \"unspecified\",\n \"auth_public\",\n \"trading_place\",\n \"trading_cancel\",\n \"trading_read\",\n \"account_admin\",\n \"public_read\",\n \"account_security\",\n \"deposit_create\",\n \"internal_transfer\",\n \"withdraw_submit\",\n \"withdraw_validate\",\n \"guard_sign\",\n \"social_provider\",\n] as const;\n\nconst RATE_LIMIT_SCOPE_VALUES = [\n \"unspecified\",\n \"client_ip\",\n \"api_key\",\n \"account\",\n \"subaccount\",\n \"connection\",\n \"service\",\n \"region\",\n \"symbol\",\n \"auth_subject\",\n] as const;\n\nconst RATE_LIMIT_REFILL_MODEL_VALUES = [\n \"unspecified\",\n \"continuous\",\n \"fixed_window\",\n \"rolling_window\",\n] as const;\n\n/** Machine-readable reason for a rate-limit rejection. */\nexport type RateLimitFailureReason = (typeof RATE_LIMIT_FAILURE_REASON_VALUES)[number];\n/** Quota policy family used for a rate-limit decision. */\nexport type RateLimitPolicyClass = (typeof RATE_LIMIT_POLICY_CLASS_VALUES)[number];\n/** Caller dimension that owns the exhausted capacity. */\nexport type RateLimitScope = (typeof RATE_LIMIT_SCOPE_VALUES)[number];\n/** Refill behavior for the exhausted quota. */\nexport type RateLimitRefillModel = (typeof RATE_LIMIT_REFILL_MODEL_VALUES)[number];\n\nconst RateLimitFailureReasonCodec = {\n protoToOutput: {\n [Proto.FailureReason.REASON_UNSPECIFIED]: \"unspecified\",\n [Proto.FailureReason.QUOTA_EXCEEDED]: \"quota_exceeded\",\n [Proto.FailureReason.AUTHORITY_UNAVAILABLE]: \"authority_unavailable\",\n } satisfies ProtoToOutput<Proto.FailureReason, RateLimitFailureReason>,\n} as const;\n\nconst RateLimitPolicyClassCodec = {\n protoToOutput: {\n [Proto.PolicyClass.CLASS_UNSPECIFIED]: \"unspecified\",\n [Proto.PolicyClass.AUTH_PUBLIC]: \"auth_public\",\n [Proto.PolicyClass.TRADING_PLACE]: \"trading_place\",\n [Proto.PolicyClass.TRADING_CANCEL]: \"trading_cancel\",\n [Proto.PolicyClass.TRADING_READ]: \"trading_read\",\n [Proto.PolicyClass.ACCOUNT_ADMIN]: \"account_admin\",\n [Proto.PolicyClass.PUBLIC_READ]: \"public_read\",\n [Proto.PolicyClass.ACCOUNT_SECURITY]: \"account_security\",\n [Proto.PolicyClass.DEPOSIT_CREATE]: \"deposit_create\",\n [Proto.PolicyClass.INTERNAL_TRANSFER]: \"internal_transfer\",\n [Proto.PolicyClass.WITHDRAW_SUBMIT]: \"withdraw_submit\",\n [Proto.PolicyClass.WITHDRAW_VALIDATE]: \"withdraw_validate\",\n [Proto.PolicyClass.GUARD_SIGN]: \"guard_sign\",\n [Proto.PolicyClass.SOCIAL_PROVIDER]: \"social_provider\",\n } satisfies ProtoToOutput<Proto.PolicyClass, RateLimitPolicyClass>,\n} as const;\n\nconst RateLimitScopeCodec = {\n protoToOutput: {\n [Proto.LimiterScope.SCOPE_UNSPECIFIED]: \"unspecified\",\n [Proto.LimiterScope.CLIENT_IP]: \"client_ip\",\n [Proto.LimiterScope.API_KEY]: \"api_key\",\n [Proto.LimiterScope.ACCOUNT]: \"account\",\n [Proto.LimiterScope.SUBACCOUNT]: \"subaccount\",\n [Proto.LimiterScope.CONNECTION]: \"connection\",\n [Proto.LimiterScope.SERVICE]: \"service\",\n [Proto.LimiterScope.REGION]: \"region\",\n [Proto.LimiterScope.SYMBOL]: \"symbol\",\n [Proto.LimiterScope.AUTH_SUBJECT]: \"auth_subject\",\n } satisfies ProtoToOutput<Proto.LimiterScope, RateLimitScope>,\n} as const;\n\nconst RateLimitRefillModelCodec = {\n protoToOutput: {\n [Proto.RefillModel.REFILL_UNSPECIFIED]: \"unspecified\",\n [Proto.RefillModel.CONTINUOUS]: \"continuous\",\n [Proto.RefillModel.FIXED_WINDOW]: \"fixed_window\",\n [Proto.RefillModel.ROLLING_WINDOW]: \"rolling_window\",\n } satisfies ProtoToOutput<Proto.RefillModel, RateLimitRefillModel>,\n} as const;\n\n/** Parses protobuf quota state into the stable SDK rate-limit detail shape. */\nexport const RateLimitDetailSchema = v.object({\n reason: enumLabelSchema(RateLimitFailureReasonCodec.protoToOutput),\n limit: OptionalBigIntStringSchema,\n remaining: OptionalBigIntStringSchema,\n retryAfterMs: OptionalBigIntStringSchema,\n policyVersion: OptionalBigIntStringSchema,\n operationId: v.string(),\n policyClass: enumLabelSchema(RateLimitPolicyClassCodec.protoToOutput),\n scope: enumLabelSchema(RateLimitScopeCodec.protoToOutput),\n refillModel: enumLabelSchema(RateLimitRefillModelCodec.protoToOutput),\n});\n\n/** Structured quota state exposed by order rejections and {@link RateLimitError}. */\nexport type RateLimitDetail = v.InferOutput<typeof RateLimitDetailSchema>;\n"],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"rate-limit.schemas.js","names":[],"sources":["../../src/shared/rate-limit.schemas.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport * as Proto from \"../gen/polyester/ratelimit/v1/types_pb.js\";\nimport type { ProtoToOutput } from \"../utils/types.js\";\nimport { enumLabelSchema } from \"./proto-enum-codec.js\";\nimport { OptionalBigIntStringSchema } from \"./schemas.js\";\n\nconst RATE_LIMIT_FAILURE_REASON_VALUES = [\n \"unspecified\",\n \"quota_exceeded\",\n \"authority_unavailable\",\n] as const;\n\nconst RATE_LIMIT_POLICY_CLASS_VALUES = [\n \"unspecified\",\n \"auth_public\",\n \"trading_place\",\n \"trading_cancel\",\n \"trading_read\",\n \"account_admin\",\n \"public_read\",\n \"account_security\",\n \"deposit_create\",\n \"internal_transfer\",\n \"withdraw_submit\",\n \"withdraw_validate\",\n \"guard_sign\",\n \"social_provider\",\n \"assistant_message\",\n \"assistant_control\",\n \"assistant_read\",\n] as const;\n\nconst RATE_LIMIT_SCOPE_VALUES = [\n \"unspecified\",\n \"client_ip\",\n \"api_key\",\n \"account\",\n \"subaccount\",\n \"connection\",\n \"service\",\n \"region\",\n \"symbol\",\n \"auth_subject\",\n] as const;\n\nconst RATE_LIMIT_REFILL_MODEL_VALUES = [\n \"unspecified\",\n \"continuous\",\n \"fixed_window\",\n \"rolling_window\",\n] as const;\n\n/** Machine-readable reason for a rate-limit rejection. */\nexport type RateLimitFailureReason = (typeof RATE_LIMIT_FAILURE_REASON_VALUES)[number];\n/** Quota policy family used for a rate-limit decision. */\nexport type RateLimitPolicyClass = (typeof RATE_LIMIT_POLICY_CLASS_VALUES)[number];\n/** Caller dimension that owns the exhausted capacity. */\nexport type RateLimitScope = (typeof RATE_LIMIT_SCOPE_VALUES)[number];\n/** Refill behavior for the exhausted quota. */\nexport type RateLimitRefillModel = (typeof RATE_LIMIT_REFILL_MODEL_VALUES)[number];\n\nconst RateLimitFailureReasonCodec = {\n protoToOutput: {\n [Proto.FailureReason.REASON_UNSPECIFIED]: \"unspecified\",\n [Proto.FailureReason.QUOTA_EXCEEDED]: \"quota_exceeded\",\n [Proto.FailureReason.AUTHORITY_UNAVAILABLE]: \"authority_unavailable\",\n } satisfies ProtoToOutput<Proto.FailureReason, RateLimitFailureReason>,\n} as const;\n\nconst RateLimitPolicyClassCodec = {\n protoToOutput: {\n [Proto.PolicyClass.CLASS_UNSPECIFIED]: \"unspecified\",\n [Proto.PolicyClass.AUTH_PUBLIC]: \"auth_public\",\n [Proto.PolicyClass.TRADING_PLACE]: \"trading_place\",\n [Proto.PolicyClass.TRADING_CANCEL]: \"trading_cancel\",\n [Proto.PolicyClass.TRADING_READ]: \"trading_read\",\n [Proto.PolicyClass.ACCOUNT_ADMIN]: \"account_admin\",\n [Proto.PolicyClass.PUBLIC_READ]: \"public_read\",\n [Proto.PolicyClass.ACCOUNT_SECURITY]: \"account_security\",\n [Proto.PolicyClass.DEPOSIT_CREATE]: \"deposit_create\",\n [Proto.PolicyClass.INTERNAL_TRANSFER]: \"internal_transfer\",\n [Proto.PolicyClass.WITHDRAW_SUBMIT]: \"withdraw_submit\",\n [Proto.PolicyClass.WITHDRAW_VALIDATE]: \"withdraw_validate\",\n [Proto.PolicyClass.GUARD_SIGN]: \"guard_sign\",\n [Proto.PolicyClass.SOCIAL_PROVIDER]: \"social_provider\",\n [Proto.PolicyClass.ASSISTANT_MESSAGE]: \"assistant_message\",\n [Proto.PolicyClass.ASSISTANT_CONTROL]: \"assistant_control\",\n [Proto.PolicyClass.ASSISTANT_READ]: \"assistant_read\",\n } satisfies ProtoToOutput<Proto.PolicyClass, RateLimitPolicyClass>,\n} as const;\n\nconst RateLimitScopeCodec = {\n protoToOutput: {\n [Proto.LimiterScope.SCOPE_UNSPECIFIED]: \"unspecified\",\n [Proto.LimiterScope.CLIENT_IP]: \"client_ip\",\n [Proto.LimiterScope.API_KEY]: \"api_key\",\n [Proto.LimiterScope.ACCOUNT]: \"account\",\n [Proto.LimiterScope.SUBACCOUNT]: \"subaccount\",\n [Proto.LimiterScope.CONNECTION]: \"connection\",\n [Proto.LimiterScope.SERVICE]: \"service\",\n [Proto.LimiterScope.REGION]: \"region\",\n [Proto.LimiterScope.SYMBOL]: \"symbol\",\n [Proto.LimiterScope.AUTH_SUBJECT]: \"auth_subject\",\n } satisfies ProtoToOutput<Proto.LimiterScope, RateLimitScope>,\n} as const;\n\nconst RateLimitRefillModelCodec = {\n protoToOutput: {\n [Proto.RefillModel.REFILL_UNSPECIFIED]: \"unspecified\",\n [Proto.RefillModel.CONTINUOUS]: \"continuous\",\n [Proto.RefillModel.FIXED_WINDOW]: \"fixed_window\",\n [Proto.RefillModel.ROLLING_WINDOW]: \"rolling_window\",\n } satisfies ProtoToOutput<Proto.RefillModel, RateLimitRefillModel>,\n} as const;\n\n/** Parses protobuf quota state into the stable SDK rate-limit detail shape. */\nexport const RateLimitDetailSchema = v.object({\n reason: enumLabelSchema(RateLimitFailureReasonCodec.protoToOutput),\n limit: OptionalBigIntStringSchema,\n remaining: OptionalBigIntStringSchema,\n retryAfterMs: OptionalBigIntStringSchema,\n policyVersion: OptionalBigIntStringSchema,\n operationId: v.string(),\n policyClass: enumLabelSchema(RateLimitPolicyClassCodec.protoToOutput),\n scope: enumLabelSchema(RateLimitScopeCodec.protoToOutput),\n refillModel: enumLabelSchema(RateLimitRefillModelCodec.protoToOutput),\n});\n\n/** Structured quota state exposed by order rejections and {@link RateLimitError}. */\nexport type RateLimitDetail = v.InferOutput<typeof RateLimitDetailSchema>;\n"],"mappings":";;;;;AAoHA,MAAa,wBAAwB,EAAE,OAAO;CAC1C,QAAQ,gBAAgB,EAvDxB,eAAe;GAC+B,IAAA;GACJ,IAAA;GACO,IAAA;CACjD,EAmDwB,EAA4B,aAAa;CACjE,OAAO;CACP,WAAW;CACX,cAAc;CACd,eAAe;CACf,aAAa,EAAE,OAAO;CACtB,aAAa,gBAAgB,EArD7B,eAAe;GAC4B,IAAA;GACN,IAAA;GACE,IAAA;GACC,IAAA;GACF,IAAA;GACC,IAAA;GACF,IAAA;GACK,IAAA;GACF,IAAA;GACG,IAAA;GACF,KAAA;GACE,KAAA;GACP,KAAA;GACK,KAAA;GACE,KAAA;GACA,KAAA;GACH,KAAA;CACxC,EAmC6B,EAA0B,aAAa;CACpE,OAAO,gBAAgB,EAhCvB,eAAe;GAC6B,IAAA;GACR,IAAA;GACF,IAAA;GACA,IAAA;GACG,IAAA;GACA,IAAA;GACH,IAAA;GACD,IAAA;GACA,IAAA;GACM,IAAA;CACvC,EAqBuB,EAAoB,aAAa;CACxD,aAAa,gBAAgB,EAlB7B,eAAe;GAC6B,IAAA;GACR,IAAA;GACE,IAAA;GACE,IAAA;CACxC,EAa6B,EAA0B,aAAa;AACxE,CAAC"}
|
|
@@ -42,7 +42,8 @@ interface ApiKeyEd25519AuthProvider {
|
|
|
42
42
|
* Receive window in whole milliseconds, 1 to 60000, sent and signed as
|
|
43
43
|
* `X-API-RECV-WINDOW`. The backend processes a request only until its timestamp
|
|
44
44
|
* plus this window and answers a later one with a retryable error. Omit for the
|
|
45
|
-
* backend default of
|
|
45
|
+
* backend default of 5000. Timestamps more than 1000 ms ahead of the server clock are
|
|
46
|
+
* refused, so keep the clock synchronized. A shorter window also frees replay capacity sooner.
|
|
46
47
|
*/
|
|
47
48
|
recvWindow?: number;
|
|
48
49
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transports.d.ts","names":[],"sources":["../../src/shared/transports.ts"],"mappings":";;;UAqCiB;EACb,SAAS;EACT,WAAW;;;KAIH,oBAAoB,KAAK;;KAGzB,sBAAsB,KAAK;;KAG3B,6BAA6B,KAAK;;;;UAK7B;EACb;;;;;;EAMA,gCAAgC;;;;;;;;;;;;UAanB;EACb;EACA,gCAAgC;;EAEhC,oBAAoB,oBAAoB,QAAQ
|
|
1
|
+
{"version":3,"file":"transports.d.ts","names":[],"sources":["../../src/shared/transports.ts"],"mappings":";;;UAqCiB;EACb,SAAS;EACT,WAAW;;;KAIH,oBAAoB,KAAK;;KAGzB,sBAAsB,KAAK;;KAG3B,6BAA6B,KAAK;;;;UAK7B;EACb;;;;;;EAMA,gCAAgC;;;;;;;;;;;;UAanB;EACb;EACA,gCAAgC;;EAEhC,oBAAoB,oBAAoB,QAAQ;;;;;;;;EAQhD"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transports.js","names":[],"sources":["../../src/shared/transports.ts"],"sourcesContent":["import { createConnectTransport } from \"@connectrpc/connect-web\";\nimport type { Transport, Interceptor } from \"@connectrpc/connect\";\nimport { toBinary, toJsonString } from \"@bufbuild/protobuf\";\nimport { createErrorMappingTransport, TIMESTAMP_SKEW_CODE } from \"./connect-error-mapping.js\";\nimport {\n AuthenticationError,\n ConfigurationError,\n isAbortError,\n isTimeoutAbortError,\n NetworkError,\n PolyesterError,\n TimeoutError,\n TimestampSkewError,\n} from \"./errors.js\";\n\nexport { isAbortError };\n\nexport type ConnectWireFormat = \"binary\" | \"json\";\n\nexport const POLYESTER_MOCK_HEADER = \"x-polyester-mock\";\n\nexport interface TransportConfig {\n apiUrl: string;\n interceptors?: Interceptor[];\n auth?: JwtAuthProvider | ApiKeyEd25519AuthProvider;\n /**\n * Connect wire format. Defaults to binary for production performance.\n * Use `json` for the API Playground visualization.\n */\n wireFormat?: ConnectWireFormat;\n /**\n * Custom fetch implementation for SDK HTTP requests. Defaults to the global\n * `fetch`, resolved on each request.\n */\n fetch?: typeof fetch;\n}\n\nexport interface Transports {\n authApi: Transport;\n publicApi: Transport;\n}\n\n/** Connect transports available to services that call authenticated APIs. */\nexport type AuthApiTransports = Pick<Transports, \"authApi\">;\n\n/** Connect transports available to services that call public APIs. */\nexport type PublicApiTransports = Pick<Transports, \"publicApi\">;\n\n/** Connect transports available to services that call both public and authenticated APIs. */\nexport type AuthAndPublicApiTransports = Pick<Transports, \"authApi\" | \"publicApi\">;\n\n/**\n * Generic JWT auth for HTTP/Connect endpoints that follow the Bearer token contract.\n */\nexport interface JwtAuthProvider {\n kind: \"jwt\";\n /**\n * Typically wraps the configured browser auth token storage. The SDK reads\n * the current value for every request and for every realtime auth check, so\n * keep this cheap and return the freshest credential rather than caching.\n */\n getToken: () => string | null | Promise<string | null>;\n}\n\n/**\n * Generic Ed25519 API key auth for HTTP/Connect endpoints that follow the\n * X-API-KEY-ID / X-API-TIMESTAMP / X-API-SIGNATURE contract.\n *\n * Each request is signed immediately before dispatch, but the runtime's fetch\n * may still queue it (connection limits). Bound concurrency for large bursts;\n * a request that waits past its receive window fails with a retryable\n * `TimestampSkewError` (or its `RequestDeadlineExceededError` subclass), and\n * retrying signs it again.\n */\nexport interface ApiKeyEd25519AuthProvider {\n kind: \"api-key-ed25519\";\n getKeyId: () => string | null | Promise<string | null>;\n /** Ed25519 secret key bytes (not hex) for signing. */\n getSecretKey: () => Uint8Array | null | Promise<Uint8Array | null>;\n /**\n * Receive window in whole milliseconds, 1 to 60000, sent and signed as\n * `X-API-RECV-WINDOW`. The backend processes a request only until its timestamp\n * plus this window and answers a later one with a retryable error. Omit for the\n * backend default of 10000. A shorter window also frees replay capacity sooner.\n */\n recvWindow?: number;\n}\n\nexport interface ApiKeyEd25519SigningRequest {\n url: string | URL;\n method: string;\n body?: Uint8Array;\n timestamp?: string;\n}\n\n/** Largest `X-API-RECV-WINDOW` the backend accepts, in milliseconds. */\nconst MAX_API_KEY_RECV_WINDOW_MS = 60_000;\n\n/**\n * Returns the fetch implementation used by SDK transports.\n */\nexport function makeFetch(fetchImpl?: typeof fetch): typeof fetch {\n const wrappedFetch = Object.assign(\n async (input: Parameters<typeof fetch>[0], init?: Parameters<typeof fetch>[1]) => {\n // Normalize headers into a mutable Headers object\n const headers = new Headers(init?.headers);\n\n let res: Response | undefined;\n try {\n res = await (fetchImpl ?? fetch)(input, {\n ...init,\n headers,\n redirect: \"manual\",\n });\n // Connect rejects anything but a 200 with a Connect content type\n // without reading the body, then aborts the request with its\n // ConnectError. Any reader still on that body (e.g. fetch\n // instrumentation reading a clone) would reject with the raw\n // ConnectError, unhandled. Buffer those bodies so the stream is\n // complete before Connect aborts.\n if (res?.body && !isConnectResponse(res)) {\n res = new Response(await res.arrayBuffer(), res);\n }\n } catch (err) {\n if (isAbortError(err)) throw err;\n if (isTimeoutAbortError(err)) {\n throw new TimeoutError(\"Request timed out.\", { cause: err });\n }\n throw new NetworkError(\"Transport request failed\", { cause: err });\n }\n // A custom or patched fetch (browser extensions, monitoring scripts) can\n // resolve without a Response.\n if (!res) throw new NetworkError(\"Transport request returned no response\");\n // Connect discards non-Connect error bodies, so surface the problem+json\n // skew code here before it collapses into a bare HTTP status error.\n if (await isTimestampSkewProblem(res)) {\n throw new TimestampSkewError(\n \"API key timestamp is outside the allowed skew window.\",\n { status: res.status },\n );\n }\n return res;\n },\n fetch,\n );\n\n return wrappedFetch;\n}\n\nconst CONNECT_CONTENT_TYPE_RE = /^application\\/(?:connect\\+)?(?:json|proto)\\s*(?:;|$)/iu;\n\nfunction isConnectResponse(res: Response): boolean {\n return (\n res.status === 200 && CONNECT_CONTENT_TYPE_RE.test(res.headers.get(\"content-type\") ?? \"\")\n );\n}\n\nasync function isTimestampSkewProblem(res: Response): Promise<boolean> {\n if (res.ok || !res.headers.get(\"content-type\")?.includes(\"application/problem+json\")) {\n return false;\n }\n try {\n const body: unknown = await res.clone().json();\n return (\n typeof body === \"object\" &&\n body !== null &&\n \"code\" in body &&\n body.code === TIMESTAMP_SKEW_CODE\n );\n } catch {\n return false;\n }\n}\n\n/**\n * Creates Connect transports for SDK service clients.\n */\nexport function createTransports(config: TransportConfig): Transports {\n const { apiUrl, interceptors = [], auth, wireFormat = \"binary\", fetch: fetchImpl } = config;\n const useBinaryFormat = wireFormat === \"binary\";\n const publicApi = createErrorMappingTransport(\n createConnectTransport({\n baseUrl: apiUrl,\n useBinaryFormat,\n // methods whose proto declares idempotency_level = NO_SIDE_EFFECTS go over\n // cacheable GET; every other method stays POST. authApi never uses GET.\n useHttpGet: true,\n interceptors,\n fetch: makeFetch(fetchImpl),\n }),\n );\n\n const authInterceptors = auth\n ? auth.kind === \"jwt\"\n ? [createAuthInterceptor(auth, { wireFormat }), ...interceptors]\n : [...interceptors, createAuthInterceptor(auth, { wireFormat })]\n : interceptors;\n const authApi = createErrorMappingTransport(\n createConnectTransport({\n baseUrl: apiUrl,\n useBinaryFormat,\n interceptors: authInterceptors,\n fetch: makeFetch(fetchImpl),\n }),\n );\n\n return { authApi, publicApi };\n}\n\n/**\n * Creates an interceptor that enables mock transport behavior.\n */\nexport function createMockInterceptor(getEnabled: () => boolean): Interceptor {\n return (next) => async (req) => {\n if (getEnabled()) req.header.set(POLYESTER_MOCK_HEADER, \"true\");\n return next(req);\n };\n}\n\nasync function sha256Hex(bytes: Uint8Array): Promise<string> {\n if (typeof crypto === \"undefined\" || !crypto.subtle) {\n throw new ConfigurationError(\"SHA-256 not available in this environment\");\n }\n const hash = await crypto.subtle.digest(\"SHA-256\", bytes.slice());\n return Array.from(new Uint8Array(hash), (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nlet lastTimestamp = 0;\nfunction nextTimestamp(): string {\n lastTimestamp = Math.max(lastTimestamp + 1, Date.now());\n return String(lastTimestamp);\n}\n\n// The signing helpers below work on byte strings: one char per byte, so `<`\n// compares bytes and non-UTF-8 escapes such as `%FF` survive. WHATWG URL\n// serializes `pathname` and `search` as ASCII, so decoding them yields one.\n\n/** Decodes `%XX` escapes, leaving malformed escapes as they are. */\nfunction percentDecode(ascii: string): string {\n return ascii.replace(/%([\\da-f]{2})/giu, (_, hex: string) =>\n String.fromCharCode(Number.parseInt(hex, 16)),\n );\n}\n\n/** Escapes every byte outside RFC 3986's unreserved set, as Go's `url.QueryEscape` with `%20` for space. */\nfunction escapeQueryComponent(bytes: string): string {\n return bytes.replace(\n /[^\\w.~-]/gu,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, \"0\")}`,\n );\n}\n\nfunction compareBytes(a: string, b: string): number {\n return a < b ? -1 : a > b ? 1 : 0;\n}\n\n/**\n * Canonicalizes a query as the server's API-key verifier does: form-decode each\n * pair, sort by key bytes then value bytes, and escape both again.\n */\nfunction canonicalQueryString(search: string): string {\n const decode = (component: string) => percentDecode(component.replaceAll(\"+\", \" \"));\n const pairs = search\n .slice(1)\n .split(\"&\")\n .filter(Boolean)\n .map((pair): [string, string] => {\n const eq = pair.indexOf(\"=\");\n return eq === -1\n ? [decode(pair), \"\"]\n : [decode(pair.slice(0, eq)), decode(pair.slice(eq + 1))];\n });\n pairs.sort(([ak, av], [bk, bv]) => compareBytes(ak, bk) || compareBytes(av, bv));\n return pairs.map(([k, v]) => `${escapeQueryComponent(k)}=${escapeQueryComponent(v)}`).join(\"&\");\n}\n\n/**\n * Creates API-key authentication headers for endpoints using the Polyester Ed25519 signing contract.\n */\nexport async function createApiKeyEd25519AuthHeaders(\n auth: ApiKeyEd25519AuthProvider,\n request: ApiKeyEd25519SigningRequest,\n): Promise<Record<string, string>> {\n let keyId: string | null;\n let secretKey: Uint8Array | null;\n try {\n [keyId, secretKey] = await Promise.all([auth.getKeyId(), auth.getSecretKey()]);\n } catch (cause) {\n if (cause instanceof PolyesterError) throw cause;\n throw new ConfigurationError(\"API key credential provider failed\", { cause });\n }\n if (!keyId || !secretKey) throw new ConfigurationError(\"Missing API key ID or secret key\");\n if (!(secretKey instanceof Uint8Array) || secretKey.byteLength !== 32) {\n throw new ConfigurationError(\"API key secret key must contain exactly 32 bytes\");\n }\n\n const { recvWindow } = auth;\n if (\n recvWindow !== undefined &&\n (!Number.isInteger(recvWindow) || recvWindow < 1 || recvWindow > MAX_API_KEY_RECV_WINDOW_MS)\n ) {\n throw new ConfigurationError(\n `API key recvWindow must be a whole number of milliseconds from 1 to ${MAX_API_KEY_RECV_WINDOW_MS}`,\n );\n }\n\n const urlObj = new URL(request.url);\n // The server refuses these whatever the signature, so fail before signing.\n if (urlObj.search.includes(\";\") || /%(?![\\da-f]{2})/iu.test(urlObj.pathname + urlObj.search)) {\n throw new ConfigurationError(\n \"Cannot sign a URL with a malformed percent-escape or a ';' in its query\",\n );\n }\n const timestamp = request.timestamp ?? nextTimestamp();\n const bodyHash = await sha256Hex(request.body ?? new Uint8Array(0));\n const canonicalQuery = canonicalQueryString(urlObj.search);\n // The window line is signed only when the header is sent.\n const windowLine = recvWindow === undefined ? \"\" : `${recvWindow}\\n`;\n // The server signs the upper-cased method and the decoded path's bytes.\n const canonical = `${timestamp}\\n${windowLine}${request.method.toUpperCase()}\\n${percentDecode(urlObj.pathname)}\\n${canonicalQuery}\\n${bodyHash}`;\n const msgBytes = Uint8Array.from(canonical, (c) => c.charCodeAt(0));\n // Loaded on demand: browser clients authenticate with JWTs and never sign.\n const { signAsync } = await import(\"@noble/ed25519\");\n const sig = await signAsync(msgBytes, secretKey);\n const signatureHex = Array.from(sig, (b: number) => b.toString(16).padStart(2, \"0\")).join(\"\");\n\n return {\n \"X-API-KEY-ID\": keyId,\n \"X-API-TIMESTAMP\": timestamp,\n ...(recvWindow === undefined ? {} : { \"X-API-RECV-WINDOW\": String(recvWindow) }),\n \"X-API-SIGNATURE\": signatureHex,\n };\n}\n\n/**\n * Resolves a JWT credential and translates provider failures or invalid values\n * into stable SDK errors.\n */\nexport async function resolveJwtToken(auth: JwtAuthProvider): Promise<string | null> {\n let token: string | null;\n try {\n token = await auth.getToken();\n } catch (cause) {\n if (cause instanceof PolyesterError) throw cause;\n throw new AuthenticationError(\"JWT token provider failed\", { cause });\n }\n if (token !== null && typeof token !== \"string\") {\n throw new ConfigurationError(\"JWT token provider must return a string or null\");\n }\n return token;\n}\n\n/**\n * Creates an interceptor that attaches SDK authentication headers.\n */\nexport function createAuthInterceptor(\n auth: JwtAuthProvider | ApiKeyEd25519AuthProvider,\n options?: { wireFormat?: ConnectWireFormat },\n): Interceptor {\n return (next) => async (req) => {\n const wireFormat = options?.wireFormat ?? \"binary\";\n if (auth.kind === \"jwt\") {\n const token = await resolveJwtToken(auth);\n if (token) {\n req.header.set(\"Authorization\", `Bearer ${token}`);\n }\n } else if (auth.kind === \"api-key-ed25519\") {\n if (req.stream) {\n throw new ConfigurationError(\n \"API key authentication does not support streaming Connect RPCs\",\n );\n }\n // Unary request: serialize the message using the method's input schema.\n const inputSchema = req.method.input;\n const bodyBytes =\n wireFormat === \"json\"\n ? new TextEncoder().encode(toJsonString(inputSchema, req.message))\n : toBinary(inputSchema, req.message);\n\n const headers = await createApiKeyEd25519AuthHeaders(auth, {\n url: req.url,\n method: req.requestMethod,\n body: bodyBytes,\n });\n for (const [key, value] of Object.entries(headers)) {\n req.header.set(key, value);\n }\n }\n return next(req);\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"transports.js","names":[],"sources":["../../src/shared/transports.ts"],"sourcesContent":["import { createConnectTransport } from \"@connectrpc/connect-web\";\nimport type { Transport, Interceptor } from \"@connectrpc/connect\";\nimport { toBinary, toJsonString } from \"@bufbuild/protobuf\";\nimport { createErrorMappingTransport, TIMESTAMP_SKEW_CODE } from \"./connect-error-mapping.js\";\nimport {\n AuthenticationError,\n ConfigurationError,\n isAbortError,\n isTimeoutAbortError,\n NetworkError,\n PolyesterError,\n TimeoutError,\n TimestampSkewError,\n} from \"./errors.js\";\n\nexport { isAbortError };\n\nexport type ConnectWireFormat = \"binary\" | \"json\";\n\nexport const POLYESTER_MOCK_HEADER = \"x-polyester-mock\";\n\nexport interface TransportConfig {\n apiUrl: string;\n interceptors?: Interceptor[];\n auth?: JwtAuthProvider | ApiKeyEd25519AuthProvider;\n /**\n * Connect wire format. Defaults to binary for production performance.\n * Use `json` for the API Playground visualization.\n */\n wireFormat?: ConnectWireFormat;\n /**\n * Custom fetch implementation for SDK HTTP requests. Defaults to the global\n * `fetch`, resolved on each request.\n */\n fetch?: typeof fetch;\n}\n\nexport interface Transports {\n authApi: Transport;\n publicApi: Transport;\n}\n\n/** Connect transports available to services that call authenticated APIs. */\nexport type AuthApiTransports = Pick<Transports, \"authApi\">;\n\n/** Connect transports available to services that call public APIs. */\nexport type PublicApiTransports = Pick<Transports, \"publicApi\">;\n\n/** Connect transports available to services that call both public and authenticated APIs. */\nexport type AuthAndPublicApiTransports = Pick<Transports, \"authApi\" | \"publicApi\">;\n\n/**\n * Generic JWT auth for HTTP/Connect endpoints that follow the Bearer token contract.\n */\nexport interface JwtAuthProvider {\n kind: \"jwt\";\n /**\n * Typically wraps the configured browser auth token storage. The SDK reads\n * the current value for every request and for every realtime auth check, so\n * keep this cheap and return the freshest credential rather than caching.\n */\n getToken: () => string | null | Promise<string | null>;\n}\n\n/**\n * Generic Ed25519 API key auth for HTTP/Connect endpoints that follow the\n * X-API-KEY-ID / X-API-TIMESTAMP / X-API-SIGNATURE contract.\n *\n * Each request is signed immediately before dispatch, but the runtime's fetch\n * may still queue it (connection limits). Bound concurrency for large bursts;\n * a request that waits past its receive window fails with a retryable\n * `TimestampSkewError` (or its `RequestDeadlineExceededError` subclass), and\n * retrying signs it again.\n */\nexport interface ApiKeyEd25519AuthProvider {\n kind: \"api-key-ed25519\";\n getKeyId: () => string | null | Promise<string | null>;\n /** Ed25519 secret key bytes (not hex) for signing. */\n getSecretKey: () => Uint8Array | null | Promise<Uint8Array | null>;\n /**\n * Receive window in whole milliseconds, 1 to 60000, sent and signed as\n * `X-API-RECV-WINDOW`. The backend processes a request only until its timestamp\n * plus this window and answers a later one with a retryable error. Omit for the\n * backend default of 5000. Timestamps more than 1000 ms ahead of the server clock are\n * refused, so keep the clock synchronized. A shorter window also frees replay capacity sooner.\n */\n recvWindow?: number;\n}\n\nexport interface ApiKeyEd25519SigningRequest {\n url: string | URL;\n method: string;\n body?: Uint8Array;\n timestamp?: string;\n}\n\n/** Largest `X-API-RECV-WINDOW` the backend accepts, in milliseconds. */\nconst MAX_API_KEY_RECV_WINDOW_MS = 60_000;\n\n/**\n * Returns the fetch implementation used by SDK transports.\n */\nexport function makeFetch(fetchImpl?: typeof fetch): typeof fetch {\n const wrappedFetch = Object.assign(\n async (input: Parameters<typeof fetch>[0], init?: Parameters<typeof fetch>[1]) => {\n // Normalize headers into a mutable Headers object\n const headers = new Headers(init?.headers);\n\n let res: Response | undefined;\n try {\n res = await (fetchImpl ?? fetch)(input, {\n ...init,\n headers,\n redirect: \"manual\",\n });\n // Connect rejects anything but a 200 with a Connect content type\n // without reading the body, then aborts the request with its\n // ConnectError. Any reader still on that body (e.g. fetch\n // instrumentation reading a clone) would reject with the raw\n // ConnectError, unhandled. Buffer those bodies so the stream is\n // complete before Connect aborts.\n if (res?.body && !isConnectResponse(res)) {\n res = new Response(await res.arrayBuffer(), res);\n }\n } catch (err) {\n if (isAbortError(err)) throw err;\n if (isTimeoutAbortError(err)) {\n throw new TimeoutError(\"Request timed out.\", { cause: err });\n }\n throw new NetworkError(\"Transport request failed\", { cause: err });\n }\n // A custom or patched fetch (browser extensions, monitoring scripts) can\n // resolve without a Response.\n if (!res) throw new NetworkError(\"Transport request returned no response\");\n // Connect discards non-Connect error bodies, so surface the problem+json\n // skew code here before it collapses into a bare HTTP status error.\n if (await isTimestampSkewProblem(res)) {\n throw new TimestampSkewError(\n \"API key timestamp is outside the allowed skew window.\",\n { status: res.status },\n );\n }\n return res;\n },\n fetch,\n );\n\n return wrappedFetch;\n}\n\nconst CONNECT_CONTENT_TYPE_RE = /^application\\/(?:connect\\+)?(?:json|proto)\\s*(?:;|$)/iu;\n\nfunction isConnectResponse(res: Response): boolean {\n return (\n res.status === 200 && CONNECT_CONTENT_TYPE_RE.test(res.headers.get(\"content-type\") ?? \"\")\n );\n}\n\nasync function isTimestampSkewProblem(res: Response): Promise<boolean> {\n if (res.ok || !res.headers.get(\"content-type\")?.includes(\"application/problem+json\")) {\n return false;\n }\n try {\n const body: unknown = await res.clone().json();\n return (\n typeof body === \"object\" &&\n body !== null &&\n \"code\" in body &&\n body.code === TIMESTAMP_SKEW_CODE\n );\n } catch {\n return false;\n }\n}\n\n/**\n * Creates Connect transports for SDK service clients.\n */\nexport function createTransports(config: TransportConfig): Transports {\n const { apiUrl, interceptors = [], auth, wireFormat = \"binary\", fetch: fetchImpl } = config;\n const useBinaryFormat = wireFormat === \"binary\";\n const publicApi = createErrorMappingTransport(\n createConnectTransport({\n baseUrl: apiUrl,\n useBinaryFormat,\n // methods whose proto declares idempotency_level = NO_SIDE_EFFECTS go over\n // cacheable GET; every other method stays POST. authApi never uses GET.\n useHttpGet: true,\n interceptors,\n fetch: makeFetch(fetchImpl),\n }),\n );\n\n const authInterceptors = auth\n ? auth.kind === \"jwt\"\n ? [createAuthInterceptor(auth, { wireFormat }), ...interceptors]\n : [...interceptors, createAuthInterceptor(auth, { wireFormat })]\n : interceptors;\n const authApi = createErrorMappingTransport(\n createConnectTransport({\n baseUrl: apiUrl,\n useBinaryFormat,\n interceptors: authInterceptors,\n fetch: makeFetch(fetchImpl),\n }),\n );\n\n return { authApi, publicApi };\n}\n\n/**\n * Creates an interceptor that enables mock transport behavior.\n */\nexport function createMockInterceptor(getEnabled: () => boolean): Interceptor {\n return (next) => async (req) => {\n if (getEnabled()) req.header.set(POLYESTER_MOCK_HEADER, \"true\");\n return next(req);\n };\n}\n\nasync function sha256Hex(bytes: Uint8Array): Promise<string> {\n if (typeof crypto === \"undefined\" || !crypto.subtle) {\n throw new ConfigurationError(\"SHA-256 not available in this environment\");\n }\n const hash = await crypto.subtle.digest(\"SHA-256\", bytes.slice());\n return Array.from(new Uint8Array(hash), (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nlet lastTimestamp = 0;\nfunction nextTimestamp(): string {\n lastTimestamp = Math.max(lastTimestamp + 1, Date.now());\n return String(lastTimestamp);\n}\n\n// The signing helpers below work on byte strings: one char per byte, so `<`\n// compares bytes and non-UTF-8 escapes such as `%FF` survive. WHATWG URL\n// serializes `pathname` and `search` as ASCII, so decoding them yields one.\n\n/** Decodes `%XX` escapes, leaving malformed escapes as they are. */\nfunction percentDecode(ascii: string): string {\n return ascii.replace(/%([\\da-f]{2})/giu, (_, hex: string) =>\n String.fromCharCode(Number.parseInt(hex, 16)),\n );\n}\n\n/** Escapes every byte outside RFC 3986's unreserved set, as Go's `url.QueryEscape` with `%20` for space. */\nfunction escapeQueryComponent(bytes: string): string {\n return bytes.replace(\n /[^\\w.~-]/gu,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, \"0\")}`,\n );\n}\n\nfunction compareBytes(a: string, b: string): number {\n return a < b ? -1 : a > b ? 1 : 0;\n}\n\n/**\n * Canonicalizes a query as the server's API-key verifier does: form-decode each\n * pair, sort by key bytes then value bytes, and escape both again.\n */\nfunction canonicalQueryString(search: string): string {\n const decode = (component: string) => percentDecode(component.replaceAll(\"+\", \" \"));\n const pairs = search\n .slice(1)\n .split(\"&\")\n .filter(Boolean)\n .map((pair): [string, string] => {\n const eq = pair.indexOf(\"=\");\n return eq === -1\n ? [decode(pair), \"\"]\n : [decode(pair.slice(0, eq)), decode(pair.slice(eq + 1))];\n });\n pairs.sort(([ak, av], [bk, bv]) => compareBytes(ak, bk) || compareBytes(av, bv));\n return pairs.map(([k, v]) => `${escapeQueryComponent(k)}=${escapeQueryComponent(v)}`).join(\"&\");\n}\n\n/**\n * Creates API-key authentication headers for endpoints using the Polyester Ed25519 signing contract.\n */\nexport async function createApiKeyEd25519AuthHeaders(\n auth: ApiKeyEd25519AuthProvider,\n request: ApiKeyEd25519SigningRequest,\n): Promise<Record<string, string>> {\n let keyId: string | null;\n let secretKey: Uint8Array | null;\n try {\n [keyId, secretKey] = await Promise.all([auth.getKeyId(), auth.getSecretKey()]);\n } catch (cause) {\n if (cause instanceof PolyesterError) throw cause;\n throw new ConfigurationError(\"API key credential provider failed\", { cause });\n }\n if (!keyId || !secretKey) throw new ConfigurationError(\"Missing API key ID or secret key\");\n if (!(secretKey instanceof Uint8Array) || secretKey.byteLength !== 32) {\n throw new ConfigurationError(\"API key secret key must contain exactly 32 bytes\");\n }\n\n const { recvWindow } = auth;\n if (\n recvWindow !== undefined &&\n (!Number.isInteger(recvWindow) || recvWindow < 1 || recvWindow > MAX_API_KEY_RECV_WINDOW_MS)\n ) {\n throw new ConfigurationError(\n `API key recvWindow must be a whole number of milliseconds from 1 to ${MAX_API_KEY_RECV_WINDOW_MS}`,\n );\n }\n\n const urlObj = new URL(request.url);\n // The server refuses these whatever the signature, so fail before signing.\n if (urlObj.search.includes(\";\") || /%(?![\\da-f]{2})/iu.test(urlObj.pathname + urlObj.search)) {\n throw new ConfigurationError(\n \"Cannot sign a URL with a malformed percent-escape or a ';' in its query\",\n );\n }\n const timestamp = request.timestamp ?? nextTimestamp();\n const bodyHash = await sha256Hex(request.body ?? new Uint8Array(0));\n const canonicalQuery = canonicalQueryString(urlObj.search);\n // The window line is signed only when the header is sent.\n const windowLine = recvWindow === undefined ? \"\" : `${recvWindow}\\n`;\n // The server signs the upper-cased method and the decoded path's bytes.\n const canonical = `${timestamp}\\n${windowLine}${request.method.toUpperCase()}\\n${percentDecode(urlObj.pathname)}\\n${canonicalQuery}\\n${bodyHash}`;\n const msgBytes = Uint8Array.from(canonical, (c) => c.charCodeAt(0));\n // Loaded on demand: browser clients authenticate with JWTs and never sign.\n const { signAsync } = await import(\"@noble/ed25519\");\n const sig = await signAsync(msgBytes, secretKey);\n const signatureHex = Array.from(sig, (b: number) => b.toString(16).padStart(2, \"0\")).join(\"\");\n\n return {\n \"X-API-KEY-ID\": keyId,\n \"X-API-TIMESTAMP\": timestamp,\n ...(recvWindow === undefined ? {} : { \"X-API-RECV-WINDOW\": String(recvWindow) }),\n \"X-API-SIGNATURE\": signatureHex,\n };\n}\n\n/**\n * Resolves a JWT credential and translates provider failures or invalid values\n * into stable SDK errors.\n */\nexport async function resolveJwtToken(auth: JwtAuthProvider): Promise<string | null> {\n let token: string | null;\n try {\n token = await auth.getToken();\n } catch (cause) {\n if (cause instanceof PolyesterError) throw cause;\n throw new AuthenticationError(\"JWT token provider failed\", { cause });\n }\n if (token !== null && typeof token !== \"string\") {\n throw new ConfigurationError(\"JWT token provider must return a string or null\");\n }\n return token;\n}\n\n/**\n * Creates an interceptor that attaches SDK authentication headers.\n */\nexport function createAuthInterceptor(\n auth: JwtAuthProvider | ApiKeyEd25519AuthProvider,\n options?: { wireFormat?: ConnectWireFormat },\n): Interceptor {\n return (next) => async (req) => {\n const wireFormat = options?.wireFormat ?? \"binary\";\n if (auth.kind === \"jwt\") {\n const token = await resolveJwtToken(auth);\n if (token) {\n req.header.set(\"Authorization\", `Bearer ${token}`);\n }\n } else if (auth.kind === \"api-key-ed25519\") {\n if (req.stream) {\n throw new ConfigurationError(\n \"API key authentication does not support streaming Connect RPCs\",\n );\n }\n // Unary request: serialize the message using the method's input schema.\n const inputSchema = req.method.input;\n const bodyBytes =\n wireFormat === \"json\"\n ? new TextEncoder().encode(toJsonString(inputSchema, req.message))\n : toBinary(inputSchema, req.message);\n\n const headers = await createApiKeyEd25519AuthHeaders(auth, {\n url: req.url,\n method: req.requestMethod,\n body: bodyBytes,\n });\n for (const [key, value] of Object.entries(headers)) {\n req.header.set(key, value);\n }\n }\n return next(req);\n };\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@polyester/sdk",
|
|
3
|
-
"version": "0.35.0-devnet-
|
|
3
|
+
"version": "0.35.0-devnet-20261111140253",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "TypeScript SDK providing access to APIs on Polyester Exchange.",
|
|
6
6
|
"homepage": "https://github.com/Fabric-Labs/polyester-sdk-typescript#readme",
|