@gauntlet-xyz/sdk 3.0.1 → 3.1.1

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.
Files changed (117) hide show
  1. package/README.md +34 -3
  2. package/dist/api/activity.d.ts +3 -1
  3. package/dist/api/activity.d.ts.map +1 -1
  4. package/dist/api/activityRows.d.ts +11 -0
  5. package/dist/api/activityRows.d.ts.map +1 -0
  6. package/dist/api/caip.d.ts.map +1 -1
  7. package/dist/api/client.d.ts.map +1 -1
  8. package/dist/api/decimal.d.ts.map +1 -1
  9. package/dist/api/http.d.ts.map +1 -1
  10. package/dist/api/index.js +7 -8
  11. package/dist/api/positionHistory.d.ts.map +1 -1
  12. package/dist/attribution/index.d.ts +5 -2
  13. package/dist/attribution/index.d.ts.map +1 -1
  14. package/dist/{chunk-HC2BS7MK.js → chunk-JJOLVL5V.js} +113 -6
  15. package/dist/chunk-JJOLVL5V.js.map +7 -0
  16. package/dist/{chunk-S2TTA45N.js → chunk-JRSNLXFY.js} +2 -2
  17. package/dist/{chunk-SU6JAKIA.js → chunk-MEKISE2T.js} +131 -47
  18. package/dist/chunk-MEKISE2T.js.map +7 -0
  19. package/dist/{chunk-7TA2OJUK.js → chunk-YQXTLIJA.js} +209 -96
  20. package/dist/chunk-YQXTLIJA.js.map +7 -0
  21. package/dist/cjs/api/activity.d.ts +3 -1
  22. package/dist/cjs/api/activity.d.ts.map +1 -1
  23. package/dist/cjs/api/activity.js +14 -12
  24. package/dist/cjs/api/activity.js.map +2 -2
  25. package/dist/cjs/api/activityRows.d.ts +11 -0
  26. package/dist/cjs/api/activityRows.d.ts.map +1 -0
  27. package/dist/cjs/api/activityRows.js +139 -0
  28. package/dist/cjs/api/activityRows.js.map +7 -0
  29. package/dist/cjs/api/caip.d.ts.map +1 -1
  30. package/dist/cjs/api/caip.js +3 -1
  31. package/dist/cjs/api/caip.js.map +2 -2
  32. package/dist/cjs/api/client.d.ts.map +1 -1
  33. package/dist/cjs/api/client.js +29 -1
  34. package/dist/cjs/api/client.js.map +2 -2
  35. package/dist/cjs/api/decimal.d.ts.map +1 -1
  36. package/dist/cjs/api/decimal.js +1 -0
  37. package/dist/cjs/api/decimal.js.map +2 -2
  38. package/dist/cjs/api/http.d.ts.map +1 -1
  39. package/dist/cjs/api/http.js +1 -0
  40. package/dist/cjs/api/http.js.map +2 -2
  41. package/dist/cjs/api/positionHistory.d.ts.map +1 -1
  42. package/dist/cjs/api/positionHistory.js +17 -4
  43. package/dist/cjs/api/positionHistory.js.map +2 -2
  44. package/dist/cjs/attribution/index.d.ts +5 -2
  45. package/dist/cjs/attribution/index.d.ts.map +1 -1
  46. package/dist/cjs/attribution/index.js +3 -1
  47. package/dist/cjs/attribution/index.js.map +2 -2
  48. package/dist/cjs/evm/adapters/aera.d.ts.map +1 -1
  49. package/dist/cjs/evm/adapters/aera.js +16 -7
  50. package/dist/cjs/evm/adapters/aera.js.map +2 -2
  51. package/dist/cjs/evm/adapters/types.d.ts +1 -0
  52. package/dist/cjs/evm/adapters/types.d.ts.map +1 -1
  53. package/dist/cjs/evm/adapters/types.js.map +1 -1
  54. package/dist/cjs/evm/aeraContracts.d.ts.map +1 -1
  55. package/dist/cjs/evm/aeraContracts.js +21 -11
  56. package/dist/cjs/evm/aeraContracts.js.map +2 -2
  57. package/dist/cjs/evm/deposit.d.ts +3 -2
  58. package/dist/cjs/evm/deposit.d.ts.map +1 -1
  59. package/dist/cjs/evm/deposit.js +40 -10
  60. package/dist/cjs/evm/deposit.js.map +2 -2
  61. package/dist/cjs/evm/depositQuote.d.ts.map +1 -1
  62. package/dist/cjs/evm/depositQuote.js +1 -0
  63. package/dist/cjs/evm/depositQuote.js.map +2 -2
  64. package/dist/cjs/evm/depositReceiverApproval.d.ts.map +1 -1
  65. package/dist/cjs/evm/depositReceiverApproval.js +14 -9
  66. package/dist/cjs/evm/depositReceiverApproval.js.map +2 -2
  67. package/dist/cjs/evm/userCurrentBalance.d.ts +15 -1
  68. package/dist/cjs/evm/userCurrentBalance.d.ts.map +1 -1
  69. package/dist/cjs/evm/userCurrentBalance.js +94 -51
  70. package/dist/cjs/evm/userCurrentBalance.js.map +2 -2
  71. package/dist/cjs/evm/withdraw.d.ts +2 -0
  72. package/dist/cjs/evm/withdraw.d.ts.map +1 -1
  73. package/dist/cjs/evm/withdraw.js +14 -1
  74. package/dist/cjs/evm/withdraw.js.map +2 -2
  75. package/dist/cjs/evm/withdrawQuote.d.ts.map +1 -1
  76. package/dist/cjs/evm/withdrawQuote.js +1 -0
  77. package/dist/cjs/evm/withdrawQuote.js.map +2 -2
  78. package/dist/evm/adapters/aera.d.ts.map +1 -1
  79. package/dist/evm/adapters/types.d.ts +1 -0
  80. package/dist/evm/adapters/types.d.ts.map +1 -1
  81. package/dist/evm/aeraContracts.d.ts.map +1 -1
  82. package/dist/evm/deposit.d.ts +3 -2
  83. package/dist/evm/deposit.d.ts.map +1 -1
  84. package/dist/evm/depositQuote.d.ts.map +1 -1
  85. package/dist/evm/depositReceiverApproval.d.ts.map +1 -1
  86. package/dist/evm/index.js +6 -8
  87. package/dist/evm/userCurrentBalance.d.ts +15 -1
  88. package/dist/evm/userCurrentBalance.d.ts.map +1 -1
  89. package/dist/evm/withdraw.d.ts +2 -0
  90. package/dist/evm/withdraw.d.ts.map +1 -1
  91. package/dist/evm/withdrawQuote.d.ts.map +1 -1
  92. package/dist/index.js +11 -13
  93. package/dist/privy/index.js +2 -2
  94. package/package.json +1 -1
  95. package/src/api/activity.ts +18 -15
  96. package/src/api/activityRows.ts +143 -0
  97. package/src/api/caip.ts +3 -1
  98. package/src/api/client.ts +36 -1
  99. package/src/api/decimal.ts +1 -0
  100. package/src/api/http.ts +1 -0
  101. package/src/api/positionHistory.ts +20 -5
  102. package/src/attribution/index.ts +6 -2
  103. package/src/evm/adapters/aera.ts +26 -8
  104. package/src/evm/adapters/types.ts +1 -0
  105. package/src/evm/aeraContracts.ts +29 -14
  106. package/src/evm/deposit.ts +43 -12
  107. package/src/evm/depositQuote.ts +1 -0
  108. package/src/evm/depositReceiverApproval.ts +14 -9
  109. package/src/evm/userCurrentBalance.ts +144 -60
  110. package/src/evm/withdraw.ts +20 -1
  111. package/src/evm/withdrawQuote.ts +1 -0
  112. package/dist/chunk-7TA2OJUK.js.map +0 -7
  113. package/dist/chunk-HC2BS7MK.js.map +0 -7
  114. package/dist/chunk-STIV2CC4.js +0 -57
  115. package/dist/chunk-STIV2CC4.js.map +0 -7
  116. package/dist/chunk-SU6JAKIA.js.map +0 -7
  117. /package/dist/{chunk-S2TTA45N.js.map → chunk-JRSNLXFY.js.map} +0 -0
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../src/constants.ts", "../src/errors.ts", "../src/api/errors.ts", "../src/api/http.ts", "../src/api/client.ts"],
4
- "sourcesContent": ["export const MAX_BPS = 10000n;\nexport const DEFAULT_BPS = 100;\n\nexport const SECOND = 1;\nexport const MINUTE = SECOND * 60;\nexport const HOUR = MINUTE * 60;\nexport const DAY = HOUR * 24;\n\nexport const REQUEST_DEADLINE_BUFFER_DAYS = 3;\nexport const DEFAULT_MAX_PRICE_AGE_DAYS = 10;\nexport const DEFAULT_SOLVER_TIP = 0n;\nexport const DEFAULT_REQUEST_DEADLINE_BUFFER = DAY * REQUEST_DEADLINE_BUFFER_DAYS;\nexport const DEFAULT_MAX_PRICE_AGE = BigInt(DAY * DEFAULT_MAX_PRICE_AGE_DAYS);\n\nexport const CHAIN_NAMES: Record<number, string> = {\n 1: 'ethereum',\n 8453: 'base',\n 42161: 'arbitrum',\n 10: 'optimism',\n 5042: 'arc',\n};\n\n// Approximate 3-day block lookback per chain based on avg block time.\nexport const BLOCKS_3_DAYS: Record<number, bigint> = {\n 1: 21_600n,\n 8453: 129_600n,\n 42161: 1_036_800n,\n 10: 129_600n,\n 5042: 518_400n,\n};\nexport const DEFAULT_BLOCKS_3_DAYS = 129_600n;\n\n// Many RPC providers cap eth_getLogs to 10,000 blocks per request.\nexport const LOG_PAGE_SIZE = 9_999n;\n", "import type { ChainId } from './client';\nimport { MAX_BPS } from './constants';\n\nexport class GauntletSDKError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'GauntletSDKError';\n }\n}\n\nexport class VaultNotFoundError extends GauntletSDKError {\n readonly vaultId: string;\n readonly chainId?: ChainId;\n\n constructor(vaultId: string, chainId?: ChainId) {\n const msg = chainId\n ? `Vault \"${vaultId}\" not found on chainId \"${chainId}\"`\n : `Vault \"${vaultId}\" not found`;\n super(msg);\n this.name = 'VaultNotFoundError';\n this.vaultId = vaultId;\n this.chainId = chainId;\n }\n}\n\nexport class UnsupportedAssetError extends GauntletSDKError {\n readonly asset: string;\n readonly vaultId: string;\n\n constructor(asset: string, vaultId: string) {\n super(`Asset \"${asset}\" is not supported by vault \"${vaultId}\"`);\n this.name = 'UnsupportedAssetError';\n this.asset = asset;\n this.vaultId = vaultId;\n }\n}\n\nexport class ChainMismatchError extends GauntletSDKError {\n readonly expected: string;\n readonly received: string;\n\n constructor(expected: string, received: string) {\n super(`Chain mismatch: expected \"${expected}\", received \"${received}\"`);\n this.name = 'ChainMismatchError';\n this.expected = expected;\n this.received = received;\n }\n}\n\nexport class UnsupportedDepositModeError extends GauntletSDKError {\n readonly vaultId: string;\n readonly requested: string;\n readonly available: string;\n\n constructor(vaultId: string, requested: string, available: string) {\n super(`Vault \"${vaultId}\" does not support ${requested} operations (available: ${available})`);\n this.name = 'UnsupportedDepositModeError';\n this.vaultId = vaultId;\n this.requested = requested;\n this.available = available;\n }\n}\n\nexport class RpcNotConfiguredError extends GauntletSDKError {\n readonly chainId: ChainId;\n\n constructor(chainId: ChainId) {\n super(`No client configured for chainId \"${chainId}\"`);\n this.name = 'RpcNotConfiguredError';\n this.chainId = chainId;\n }\n}\n\nexport class AccountRequiredError extends GauntletSDKError {\n constructor() {\n super(\n 'No account specified. Pass the required account, or configure a wallet when building transactions.'\n );\n this.name = 'AccountRequiredError';\n }\n}\n\nexport class AccountMismatchError extends GauntletSDKError {\n readonly expected: string;\n readonly received: string;\n\n constructor(expected: string, received: string) {\n super(`Account mismatch: expected \"${expected}\", received \"${received}\"`);\n this.name = 'AccountMismatchError';\n this.expected = expected;\n this.received = received;\n }\n}\n\nexport class UnsupportedProtocolError extends GauntletSDKError {\n readonly protocol: string;\n\n constructor(protocol: string) {\n super(`Unsupported protocol: \"${protocol}\"`);\n this.name = 'UnsupportedProtocolError';\n this.protocol = protocol;\n }\n}\n\nexport class InvalidWithdrawParamsError extends GauntletSDKError {\n constructor() {\n super('Withdraw requires exactly one of: shares, amount, or all');\n this.name = 'InvalidWithdrawParamsError';\n }\n}\n\nexport type SyncWithdrawBound = 'tokensOut' | 'minTokensOut' | 'unitsIn' | 'maxUnitsIn';\n\nexport class InvalidSyncWithdrawBoundError extends GauntletSDKError {\n readonly bound: SyncWithdrawBound;\n\n constructor(bound: SyncWithdrawBound) {\n super(`Sync withdraw cannot submit zero ${bound}; increase the amount or reduce slippage`);\n this.name = 'InvalidSyncWithdrawBoundError';\n this.bound = bound;\n }\n}\n\nexport function requireNonZeroSyncWithdrawBound(value: bigint, bound: SyncWithdrawBound) {\n if (value === 0n) throw new InvalidSyncWithdrawBoundError(bound);\n}\n\nexport class UnimplementedFeatureError extends GauntletSDKError {\n readonly feature: string;\n\n constructor(feature: string) {\n super(`Feature not yet implemented: \"${feature}\"`);\n this.name = 'UnimplementedFeatureError';\n this.feature = feature;\n }\n}\n\nexport class UnsupportedFeatureError extends GauntletSDKError {\n readonly feature: string;\n\n constructor(feature: string) {\n super(`Feature not supported: \"${feature}\"`);\n this.name = 'UnsupportedFeatureError';\n this.feature = feature;\n }\n}\n\nexport class UnitConversionError extends GauntletSDKError {\n readonly vaultAddress: string;\n\n constructor(vaultAddress: string) {\n super(`Failed to convert token units for vault \"${vaultAddress}\": fee calculator unavailable`);\n this.name = 'UnitConversionError';\n this.vaultAddress = vaultAddress;\n }\n}\n\nexport class StalePriceError extends GauntletSDKError {\n readonly blockTimestamp: bigint;\n readonly maxPriceAge: bigint;\n readonly priceTimestamp: bigint;\n\n constructor({\n blockTimestamp,\n maxPriceAge,\n priceTimestamp,\n }: {\n blockTimestamp: bigint;\n maxPriceAge: bigint;\n priceTimestamp: bigint;\n }) {\n super(\n `Price is stale: timestamp \"${priceTimestamp}\" with max age \"${maxPriceAge}\" is older than block timestamp \"${blockTimestamp}\"`\n );\n this.name = 'StalePriceError';\n this.blockTimestamp = blockTimestamp;\n this.maxPriceAge = maxPriceAge;\n this.priceTimestamp = priceTimestamp;\n }\n}\n\nexport class InvalidSolverTipError extends GauntletSDKError {\n readonly solverTip: bigint;\n readonly availableAmount: bigint;\n\n constructor(solverTip: bigint, availableAmount: bigint) {\n super(\n `Solver tip \"${solverTip}\" must be less than available token amount \"${availableAmount}\"`\n );\n this.name = 'InvalidSolverTipError';\n this.solverTip = solverTip;\n this.availableAmount = availableAmount;\n }\n}\n\nexport class InvalidSlippageBPSError extends GauntletSDKError {\n readonly slippage: number;\n\n constructor(slippage: number) {\n super(`Slippage not in range of 0-${Number(MAX_BPS)}; argument passed: ${slippage}`);\n this.name = 'IncorrectArgument';\n this.slippage = slippage;\n }\n}\n\nexport class InvalidSyncDepositBoundError extends GauntletSDKError {\n constructor() {\n super('Sync deposit minUnitsOut requires explicit sync mode and must be greater than zero');\n this.name = 'InvalidSyncDepositBoundError';\n }\n}\n", "import { GauntletSDKError } from '../errors';\n\nexport class GauntletApiError extends GauntletSDKError {\n readonly status: number;\n readonly path: string;\n /** Machine-readable code from the API error envelope (e.g. `NOT_FOUND`), when present. */\n readonly code?: string;\n\n constructor(params: { status: number; path: string; message: string; code?: string }) {\n super(\n `Gauntlet API request to \"${params.path}\" failed with ${params.status}: ${params.message}`\n );\n this.name = 'GauntletApiError';\n this.status = params.status;\n this.path = params.path;\n this.code = params.code;\n }\n}\n\nexport class InvalidDecimalError extends GauntletSDKError {\n readonly value: string;\n\n constructor(value: string) {\n super(`Value \"${value}\" is not a valid decimal string`);\n this.name = 'InvalidDecimalError';\n this.value = value;\n }\n}\n\nexport class DecimalPrecisionError extends GauntletSDKError {\n readonly value: string;\n readonly decimals: number;\n\n constructor(value: string, decimals: number) {\n super(\n `Decimal \"${value}\" has more fractional digits than the token's ${decimals} decimals; converting would lose precision`\n );\n this.name = 'DecimalPrecisionError';\n this.value = value;\n this.decimals = decimals;\n }\n}\n\nexport class InvalidCaipIdError extends GauntletSDKError {\n readonly id: string;\n\n constructor(id: string) {\n super(`\"${id}\" is not a valid CAIP-10 vault id (expected \"{chainId}:{address}\")`);\n this.name = 'InvalidCaipIdError';\n this.id = id;\n }\n}\n\nexport class SettlementTimeoutError extends GauntletSDKError {\n readonly requestHash: string;\n readonly timeoutMs: number;\n\n constructor(requestHash: string, timeoutMs: number) {\n super(`Request \"${requestHash}\" did not settle within ${timeoutMs}ms`);\n this.name = 'SettlementTimeoutError';\n this.requestHash = requestHash;\n this.timeoutMs = timeoutMs;\n }\n}\n", "import { GauntletApiError } from './errors';\n\nexport const DEFAULT_API_URL = 'https://api.gauntlet.xyz';\n\nexport interface GauntletApiConfig {\n /** Kong consumer key sent as `x-api-key`. Anonymous access is rate-limited. */\n apiKey?: string;\n /**\n * Override the API origin. Defaults to `https://api.gauntlet.xyz`. In a\n * browser this may be a relative path (e.g. a Next.js rewrite like\n * `/gauntlet-api`), which resolves against the page origin.\n */\n apiUrl?: string;\n /** Custom fetch implementation (testing, instrumentation). Defaults to global fetch. */\n fetch?: typeof fetch;\n}\n\nexport type QueryParams = Record<string, string | number | boolean | undefined>;\n\nexport async function apiGet<T>(\n config: GauntletApiConfig,\n path: string,\n query?: QueryParams\n): Promise<T> {\n // Concatenate instead of `new URL(path, base)`: the paths are absolute, so\n // URL resolution would silently drop any path prefix on a proxy apiUrl.\n const base = (config.apiUrl ?? DEFAULT_API_URL).replace(/\\/+$/, '');\n // Relative bases resolve against the browser origin.\n const origin = (globalThis as { location?: { origin: string } }).location?.origin;\n if (origin === undefined && !/^[a-z][a-z0-9+.-]*:\\/\\//i.test(base)) {\n throw new Error(\n `relative apiUrl \"${base}\" requires a browser origin; pass an absolute apiUrl outside the browser`\n );\n }\n const url = new URL(base + path, origin);\n for (const [key, value] of Object.entries(query ?? {})) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n\n const fetchImpl = config.fetch ?? fetch;\n const response = await fetchImpl(url, {\n headers: {\n accept: 'application/json',\n ...(config.apiKey ? { 'x-api-key': config.apiKey } : {}),\n },\n });\n\n if (!response.ok) {\n let message = response.statusText || 'request failed';\n let code: string | undefined;\n try {\n const body = (await response.json()) as { error?: { code?: string; message?: string } };\n message = body.error?.message ?? message;\n code = body.error?.code;\n } catch {\n // non-JSON error body \u2014 keep the status text\n }\n throw new GauntletApiError({ status: response.status, path, message, code });\n }\n\n return (await response.json()) as T;\n}\n", "import type { components } from './generated';\nimport { apiGet, type GauntletApiConfig, type QueryParams } from './http';\n\ntype Schemas = components['schemas'];\n\nexport type UserActivity = Schemas['UserActivity'];\nexport type UserActivityResponse = Schemas['UserActivityResponse'];\nexport type UserPosition = Schemas['UserPosition'];\nexport type UserAllPositionsResponse = Schemas['UserAllPositionsResponse'];\nexport type UserPositionLatestResponse = Schemas['UserPositionLatestResponse'];\nexport type UserPositionsTimeseriesResponse = Schemas['UserPositionsTimeseriesResponse'];\nexport type PositionTimeseriesPoint = Schemas['PositionTimeseriesPoint'];\nexport type VaultDetail = Schemas['VaultDetail'];\nexport type VaultDetailResponse = Schemas['VaultDetailResponse'];\nexport type VaultListResponse = Schemas['VaultListResponse'];\nexport type VaultAllocations = Schemas['VaultAllocations'];\nexport type VaultAllocationsResponse = Schemas['VaultAllocationsResponse'];\nexport type VaultTimeseriesResponse = Schemas['VaultTimeseriesResponse'];\nexport type VaultGroupTimeseriesResponse = Schemas['VaultGroupTimeseriesResponse'];\nexport type VaultGroupTimeseriesPoint = Schemas['VaultGroupTimeseriesPoint'];\nexport type VaultTimeseriesPoint = Schemas['VaultTimeseriesPoint'];\nexport type VaultMetrics = Schemas['VaultMetrics'];\nexport type FeaturedVault = Schemas['FeaturedVault'];\nexport type FeaturedVaultsResponse = Schemas['FeaturedVaultsResponse'];\nexport type StrategyCard = Schemas['StrategyCard'];\nexport type StrategyListResponse = Schemas['StrategyListResponse'];\nexport type TvlResponse = Schemas['TvlResponse'];\nexport type TvlBreakdownMode = Schemas['TvlBreakdownMode'];\nexport type TvlTimeseriesResponse = Schemas['TvlTimeseriesResponse'];\nexport type TvlTimeseriesPoint = Schemas['TvlTimeseriesPoint'];\nexport type LatestPriceResponse = Schemas['LatestPriceResponse'];\nexport type PriceTimeseriesResponse = Schemas['TimeseriesResponse'];\nexport type TokenRef = Schemas['TokenRef'];\nexport type PartialResponseError = Schemas['PartialResponseError'];\nexport type AmountPair = Schemas['AmountPair'];\nexport type TimeseriesMeta = Schemas['TimeseriesMeta'];\nexport type HealthResponse = Schemas['HealthResponse'];\nexport type ChainSyncStatus = Schemas['ChainSyncStatus'];\n\nexport interface PageOptions {\n /** Opaque cursor from a previous response's `meta.next_cursor`. */\n next?: string;\n limit?: number;\n order?: 'asc' | 'desc';\n}\n\nexport interface TimeWindowOptions extends PageOptions {\n /** ISO 8601 date (`2026-01-01`) or RFC 3339 timestamp. */\n start?: string;\n end?: string;\n granularity?: 'hour' | 'day' | 'week' | 'month';\n}\n\nexport interface ActivityOptions extends PageOptions {\n /** CAIP-10 vault id (`\"{chainId}:{address}\"`). Omit for wallet-wide activity. */\n vaultId?: string;\n /**\n * Wallet-wide feeds only: include activity in hidden (enabled but unlisted)\n * vaults alongside visible ones. Activity in disabled vaults is never\n * returned. Ignored when `vaultId` is set.\n */\n includeHidden?: boolean;\n}\n\nexport interface PositionsOptions extends PageOptions {\n /**\n * Include positions in hidden (enabled but unlisted) vaults alongside\n * visible ones. Positions in disabled vaults are never returned.\n */\n includeHidden?: boolean;\n}\n\nexport interface VaultsOptions extends PageOptions {\n /**\n * Include hidden (enabled but unlisted) vaults alongside visible ones.\n * Disabled vaults are never listed.\n */\n includeHidden?: boolean;\n}\n\nexport interface LatestPriceOptions {\n address: string;\n chainId: number;\n /** Optional ISO 8601 timestamp for a point-in-time price. */\n at?: string;\n}\n\nexport interface PriceTimeseriesOptions {\n address: string;\n chainId: number;\n start: string;\n end: string;\n granularity?: 'raw' | 'hour' | 'day' | 'week' | 'month';\n limit?: number;\n}\n\n/**\n * Typed client for the Gaia REST API (api.gauntlet.xyz).\n *\n * All response types are generated from the service's OpenAPI spec\n * (`src/api/generated.ts`, regenerated via `yarn generate:api-types`) so they\n * cannot drift from the server models. Values are returned exactly as the API\n * emits them \u2014 human-unit decimal strings and CAIP-10 vault ids; use\n * `decimalToBigInt` / `sharesToBigInt` and `apiVaultIdFromVaultId` /\n * `vaultIdFromApiVaultId` to convert, or the higher-level `activityFlows` /\n * `positionHistory` helpers for pre-normalized values.\n *\n * Available on a configured client as `client.api`, or standalone:\n * ```ts\n * const api = new GauntletApi({ apiKey: process.env.GAUNTLET_API_KEY });\n * const { data } = await api.vaults();\n * ```\n */\nexport class GauntletApi {\n private readonly config: GauntletApiConfig;\n\n constructor(config: GauntletApiConfig = {}) {\n this.config = config;\n }\n\n private get<T>(path: string, query?: QueryParams): Promise<T> {\n return apiGet<T>(this.config, path, query);\n }\n\n /** GET /health \u2014 service liveness (version + uptime). */\n health(): Promise<HealthResponse> {\n return this.get('/health');\n }\n\n /** GET /health/chains \u2014 per-chain indexer sync freshness. */\n chainSyncStatus(): Promise<ChainSyncStatus[]> {\n return this.get('/health/chains');\n }\n\n /** GET /v1/vaults \u2014 all indexed vaults with live metrics (TVL, APY, unit price). */\n vaults(options: VaultsOptions = {}): Promise<{ data: VaultDetail[]; meta: TimeseriesMeta }> {\n return this.get('/v1/vaults', {\n next: options.next,\n limit: options.limit,\n include_hidden: options.includeHidden,\n });\n }\n\n /** GET /v1/vaults/slug/{slug} \u2014 all enabled deployments for one exact vault slug. */\n vaultsBySlug(slug: string): Promise<VaultListResponse> {\n return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}`);\n }\n\n /** GET /v1/vaults/slug/{slug}/timeseries \u2014 aggregate USD TVL and supply, plus primary-deployment metrics.\n * APY and unit price come from meta.resolved_vault_id; null marks missing data.\n */\n vaultTimeseriesBySlug(\n slug: string,\n options: TimeWindowOptions = {}\n ): Promise<VaultGroupTimeseriesResponse> {\n return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/timeseries`, { ...options });\n }\n\n /** GET /v1/vaults/slug/{slug}/primary/timeseries \u2014 primary deployment history. */\n primaryVaultTimeseriesBySlug(\n slug: string,\n options: TimeWindowOptions = {}\n ): Promise<VaultTimeseriesResponse> {\n return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/primary/timeseries`, {\n ...options,\n });\n }\n\n /** GET /v1/vaults/featured \u2014 admin-curated featured vault cards. */\n featuredVaults(): Promise<FeaturedVaultsResponse> {\n return this.get('/v1/vaults/featured');\n }\n\n /** GET /v1/strategies \u2014 admin-curated strategy cards. */\n strategies(): Promise<StrategyListResponse> {\n return this.get('/v1/strategies');\n }\n\n /** GET /v1/vaults/{vault_id} \u2014 one vault with live metrics. `vaultId` is CAIP-10. */\n vault(vaultId: string): Promise<VaultDetailResponse> {\n return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}`);\n }\n\n /** GET /v1/vaults/{vault_id}/definition \u2014 raw indexed vault definition. */\n vaultDefinition(vaultId: string): Promise<unknown> {\n return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/definition`);\n }\n\n /** GET /v1/vaults/{vault_id}/allocations \u2014 current Aera allocations with source lineage. */\n vaultAllocations(vaultId: string): Promise<VaultAllocationsResponse> {\n return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/allocations`);\n }\n\n /** GET /v1/vaults/{vault_id}/timeseries \u2014 TVL / unit-price / APY history. */\n vaultTimeseries(\n vaultId: string,\n options: TimeWindowOptions = {}\n ): Promise<VaultTimeseriesResponse> {\n return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/timeseries`, { ...options });\n }\n\n /** GET /v1/users/{wallet}/positions \u2014 all of a wallet's indexed positions with PnL. */\n positions(\n walletAddress: string,\n options: PositionsOptions = {}\n ): Promise<UserAllPositionsResponse> {\n return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/positions`, {\n next: options.next,\n limit: options.limit,\n include_hidden: options.includeHidden,\n });\n }\n\n /** GET /v1/users/{wallet}/positions/{vault_id} \u2014 one position with PnL breakdown. */\n position(walletAddress: string, vaultId: string): Promise<UserPositionLatestResponse> {\n return this.get(\n `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}`\n );\n }\n\n /** GET /v1/users/{wallet}/positions/{vault_id}/timeseries \u2014 value / cost-basis / PnL / ROI history. */\n positionTimeseries(\n walletAddress: string,\n vaultId: string,\n options: TimeWindowOptions = {}\n ): Promise<UserPositionsTimeseriesResponse> {\n return this.get(\n `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}/timeseries`,\n { ...options }\n );\n }\n\n /** GET /v1/users/{wallet}/activity \u2014 one page of the wallet's immutable event log. */\n activity(walletAddress: string, options: ActivityOptions = {}): Promise<UserActivityResponse> {\n const { vaultId, includeHidden, ...page } = options;\n return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/activity`, {\n vault_id: vaultId,\n include_hidden: includeHidden,\n ...page,\n });\n }\n\n /**\n * Iterates the wallet's full activity log, following `meta.next_cursor`\n * across pages so callers never handle cursors.\n */\n async *activityRows(\n walletAddress: string,\n options: Omit<ActivityOptions, 'next'> = {}\n ): AsyncGenerator<UserActivity> {\n let next: string | undefined;\n do {\n const page = await this.activity(walletAddress, { ...options, next });\n yield* page.data;\n next = page.meta.next_cursor ?? undefined;\n } while (next);\n }\n\n /**\n * GET /v1/tvl \u2014 aggregate Gauntlet TVL. Pass `mode` for a `breakdown`:\n * `chain` for one row per chain, `strategy` for one row per curated\n * strategy. Omit it for the headline totals only.\n */\n tvl(options: { mode?: TvlBreakdownMode } = {}): Promise<TvlResponse> {\n return this.get('/v1/tvl', { mode: options.mode });\n }\n\n /**\n * GET /v1/tvl/timeseries \u2014 daily aggregate Gauntlet TVL over a fixed\n * 3-month trailing window. `mode` partitions each point's `sources` the\n * same way `tvl()` partitions its `breakdown`; a point's total never\n * depends on it.\n */\n tvlTimeseries(options: { mode?: TvlBreakdownMode } = {}): Promise<TvlTimeseriesResponse> {\n return this.get('/v1/tvl/timeseries', { mode: options.mode });\n }\n\n /** GET /v1/prices \u2014 latest USD price for a token. */\n latestPrice(options: LatestPriceOptions): Promise<LatestPriceResponse> {\n return this.get('/v1/prices', {\n address: options.address,\n chain_id: options.chainId,\n at: options.at,\n });\n }\n\n /** GET /v1/prices/timeseries \u2014 USD price history for a token. */\n priceTimeseries(options: PriceTimeseriesOptions): Promise<PriceTimeseriesResponse> {\n return this.get('/v1/prices/timeseries', {\n address: options.address,\n chain_id: options.chainId,\n start: options.start,\n end: options.end,\n granularity: options.granularity,\n limit: options.limit,\n });\n }\n}\n"],
5
- "mappings": "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",
6
- "names": []
7
- }
@@ -1,57 +0,0 @@
1
- import {
2
- ChainMismatchError
3
- } from "./chunk-HC2BS7MK.js";
4
-
5
- // src/evm/vaults.ts
6
- import { base } from "viem/chains";
7
- var VaultId = /* @__PURE__ */ ((VaultId2) => {
8
- VaultId2["BaseUsdcPrime"] = "baseUsdcPrime";
9
- VaultId2["EthUsdcPrime"] = "ethUsdcPrime";
10
- VaultId2["AeraUsdAlpha"] = "gtusda";
11
- VaultId2["EthUsdcPrimeV2"] = "ethUsdcPrimeV2";
12
- VaultId2["AeraLeveredFalconX"] = "gpaafalconx";
13
- VaultId2["AeraSyrupUsdc"] = "gpsyrupusdc";
14
- VaultId2["AeraBtcYield"] = "gtbtc";
15
- VaultId2["AeraLeveredUscc"] = "gtuscc";
16
- VaultId2["AeraLend"] = "gtlend";
17
- VaultId2["AeraKastEth"] = "kasteth";
18
- return VaultId2;
19
- })(VaultId || {});
20
- async function getVaults(client, filter) {
21
- const manifest = await client.manifest;
22
- let vaults = manifest.vaults;
23
- if (filter?.chainId) {
24
- vaults = vaults.filter(
25
- (v) => v.deployments.some((d) => d.chain === "evm" && d.chainId === filter.chainId)
26
- );
27
- }
28
- if (filter?.protocol) {
29
- vaults = vaults.filter((v) => v.protocol === filter.protocol);
30
- }
31
- return vaults;
32
- }
33
- async function resolveVault(client, vaultId, chainId) {
34
- const manifest = await client.manifest;
35
- const vaultInfo = manifest.vaults.find((v) => v.vaultId === vaultId);
36
- if (!vaultInfo) return void 0;
37
- const evmDeployments = vaultInfo.deployments.filter(
38
- (d) => d.chain === "evm"
39
- );
40
- if (evmDeployments.length === 1) {
41
- if (chainId !== void 0 && evmDeployments[0].chainId !== chainId) {
42
- throw new ChainMismatchError(`${chainId}`, `${evmDeployments[0].chainId}`);
43
- }
44
- return { vault: evmDeployments[0], protocol: vaultInfo.protocol };
45
- }
46
- const defaultChainId = chainId ?? base.id;
47
- const deployment = evmDeployments.find((d) => d.chainId === defaultChainId);
48
- if (!deployment) return void 0;
49
- return { vault: deployment, protocol: vaultInfo.protocol };
50
- }
51
-
52
- export {
53
- VaultId,
54
- getVaults,
55
- resolveVault
56
- };
57
- //# sourceMappingURL=chunk-STIV2CC4.js.map
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../src/evm/vaults.ts"],
4
- "sourcesContent": ["import { base } from 'viem/chains';\nimport type { GauntletClient } from '../client';\nimport type { EvmVaultDeployment, VaultDeployment, VaultInfo } from './types';\nimport { ChainMismatchError } from '../errors';\n\nexport enum VaultId {\n BaseUsdcPrime = 'baseUsdcPrime',\n EthUsdcPrime = 'ethUsdcPrime',\n AeraUsdAlpha = 'gtusda',\n EthUsdcPrimeV2 = 'ethUsdcPrimeV2',\n AeraLeveredFalconX = 'gpaafalconx',\n AeraSyrupUsdc = 'gpsyrupusdc',\n AeraBtcYield = 'gtbtc',\n AeraLeveredUscc = 'gtuscc',\n AeraLend = 'gtlend',\n AeraKastEth = 'kasteth',\n}\n\nexport interface VaultFilter {\n /** Filter to vaults that have at least one EVM deployment on this chainId. */\n chainId?: number;\n protocol?: string;\n}\n\n/**\n * Returns vaults from the bundled manifest, optionally filtered by chain and/or protocol.\n * Does not make any network requests.\n *\n * @param client - A configured `GauntletClient` instance.\n * @param filter - Optional filter criteria. `chainId` restricts results to vaults that have\n * at least one EVM deployment on that chain. `protocol` restricts results to a specific\n * protocol (e.g. `'aera'`, `'morpho'`).\n * @returns Array of `VaultInfo` objects matching the filter, or all vaults if no filter is given.\n *\n * @example\n * ```ts\n * // All vaults on Base\n * const vaults = await getVaults(client, { chainId: base.id });\n *\n * // All Aera vaults\n * const aeraVaults = await getVaults(client, { protocol: 'aera' });\n * ```\n */\nexport async function getVaults(\n client: GauntletClient,\n filter?: VaultFilter\n): Promise<VaultInfo[]> {\n const manifest = await client.manifest;\n let vaults = manifest.vaults;\n\n if (filter?.chainId) {\n vaults = vaults.filter((v) =>\n v.deployments.some((d) => d.chain === 'evm' && d.chainId === filter.chainId)\n );\n }\n\n if (filter?.protocol) {\n vaults = vaults.filter((v) => v.protocol === filter.protocol);\n }\n\n return vaults;\n}\n\nexport async function resolveVault(\n client: GauntletClient,\n vaultId: string,\n chainId?: string | number\n): Promise<{ vault: VaultDeployment; protocol: string } | undefined> {\n const manifest = await client.manifest;\n const vaultInfo = manifest.vaults.find((v) => v.vaultId === vaultId);\n if (!vaultInfo) return undefined;\n\n const evmDeployments = vaultInfo.deployments.filter(\n (d): d is EvmVaultDeployment => d.chain === 'evm'\n );\n\n if (evmDeployments.length === 1) {\n // if user specifies a chain we need to make sure they get it\n if (chainId !== undefined && evmDeployments[0].chainId !== chainId) {\n throw new ChainMismatchError(`${chainId}`, `${evmDeployments[0].chainId}`);\n }\n // otherwise they're expected to know what chain\n // the single chain vault they request is on\n return { vault: evmDeployments[0], protocol: vaultInfo.protocol };\n }\n\n // now we default to base\n const defaultChainId = chainId ?? base.id;\n\n const deployment = evmDeployments.find((d) => d.chainId === defaultChainId);\n if (!deployment) return undefined;\n\n return { vault: deployment, protocol: vaultInfo.protocol };\n}\n"],
5
- "mappings": ";;;;;AAAA,SAAS,YAAY;AAKd,IAAK,UAAL,kBAAKA,aAAL;AACL,EAAAA,SAAA,mBAAgB;AAChB,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,oBAAiB;AACjB,EAAAA,SAAA,wBAAqB;AACrB,EAAAA,SAAA,mBAAgB;AAChB,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,qBAAkB;AAClB,EAAAA,SAAA,cAAW;AACX,EAAAA,SAAA,iBAAc;AAVJ,SAAAA;AAAA,GAAA;AAsCZ,eAAsB,UACpB,QACA,QACsB;AACtB,QAAM,WAAW,MAAM,OAAO;AAC9B,MAAI,SAAS,SAAS;AAEtB,MAAI,QAAQ,SAAS;AACnB,aAAS,OAAO;AAAA,MAAO,CAAC,MACtB,EAAE,YAAY,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,YAAY,OAAO,OAAO;AAAA,IAC7E;AAAA,EACF;AAEA,MAAI,QAAQ,UAAU;AACpB,aAAS,OAAO,OAAO,CAAC,MAAM,EAAE,aAAa,OAAO,QAAQ;AAAA,EAC9D;AAEA,SAAO;AACT;AAEA,eAAsB,aACpB,QACA,SACA,SACmE;AACnE,QAAM,WAAW,MAAM,OAAO;AAC9B,QAAM,YAAY,SAAS,OAAO,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO;AACnE,MAAI,CAAC,UAAW,QAAO;AAEvB,QAAM,iBAAiB,UAAU,YAAY;AAAA,IAC3C,CAAC,MAA+B,EAAE,UAAU;AAAA,EAC9C;AAEA,MAAI,eAAe,WAAW,GAAG;AAE/B,QAAI,YAAY,UAAa,eAAe,CAAC,EAAE,YAAY,SAAS;AAClE,YAAM,IAAI,mBAAmB,GAAG,OAAO,IAAI,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE;AAAA,IAC3E;AAGA,WAAO,EAAE,OAAO,eAAe,CAAC,GAAG,UAAU,UAAU,SAAS;AAAA,EAClE;AAGA,QAAM,iBAAiB,WAAW,KAAK;AAEvC,QAAM,aAAa,eAAe,KAAK,CAAC,MAAM,EAAE,YAAY,cAAc;AAC1E,MAAI,CAAC,WAAY,QAAO;AAExB,SAAO,EAAE,OAAO,YAAY,UAAU,UAAU,SAAS;AAC3D;",
6
- "names": ["VaultId"]
7
- }
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../src/api/decimal.ts", "../src/api/caip.ts", "../src/api/activity.ts", "../src/api/positionHistory.ts"],
4
- "sourcesContent": ["import { formatUnits } from 'viem';\nimport { DecimalPrecisionError, InvalidDecimalError } from './errors';\n\nconst DECIMAL_RE = /^(-?)(\\d+)(?:\\.(\\d+))?$/;\n\n/**\n * Converts an API decimal string (human units, e.g. `\"1250.5\"`) into base-unit\n * bigint at the given token decimals (e.g. `1250500000n` for 6 decimals).\n *\n * The conversion is exact: a value with more significant fractional digits\n * than `decimals` throws `DecimalPrecisionError` rather than rounding.\n * Hand-rolled instead of viem's `parseUnits`, which silently rounds excess\n * precision (`parseUnits('1.0000005', 6)` \u2192 `1000001n`) \u2014 unacceptable for\n * financial amounts.\n */\nexport function decimalToBigInt(value: string, decimals: number): bigint {\n if (!Number.isInteger(decimals) || decimals < 0) {\n throw new InvalidDecimalError(`decimals=${decimals}`);\n }\n const match = DECIMAL_RE.exec(value);\n if (!match) throw new InvalidDecimalError(value);\n\n const [, sign, whole, frac = ''] = match;\n if (frac.length > decimals && !/^0*$/.test(frac.slice(decimals))) {\n throw new DecimalPrecisionError(value, decimals);\n }\n\n const scaled = BigInt(whole + frac.slice(0, decimals).padEnd(decimals, '0'));\n return sign === '-' ? -scaled : scaled;\n}\n\n/**\n * Formats a base-unit bigint back into the API's human decimal-string\n * representation (no trailing fractional zeros, no exponent notation).\n */\nexport function bigIntToDecimal(value: bigint, decimals: number): string {\n if (!Number.isInteger(decimals) || decimals < 0) {\n throw new InvalidDecimalError(`decimals=${decimals}`);\n }\n return formatUnits(value, decimals);\n}\n\n/** Vault shares are always reported in 18-decimal units by the Gaia API. */\nexport const SHARE_DECIMALS = 18;\n\n/** Parses an API share amount (decimal string) into base-unit bigint (1e18). */\nexport function sharesToBigInt(value: string): bigint {\n return decimalToBigInt(value, SHARE_DECIMALS);\n}\n", "import type { GauntletClient } from '../client';\nimport { VaultNotFoundError } from '../errors';\nimport { resolveVault } from '../evm/vaults';\nimport { InvalidCaipIdError } from './errors';\n\n/**\n * The Gaia API identifies vaults as `\"{chainId}:{address}\"` with a lowercase\n * address (a CAIP-10-style account id without the `eip155` namespace prefix).\n */\nexport interface ApiVaultId {\n chainId: number;\n /** Lowercase EVM address. */\n address: string;\n}\n\nexport function parseApiVaultId(id: string): ApiVaultId {\n const match = /^(?:eip155:)?(\\d+):(0x[0-9a-fA-F]{40})$/.exec(id);\n if (!match) throw new InvalidCaipIdError(id);\n return { chainId: Number(match[1]), address: match[2].toLowerCase() };\n}\n\nexport function formatApiVaultId(chainId: number, address: string): string {\n return `${chainId}:${address.toLowerCase()}`;\n}\n\n/**\n * Resolves a manifest vault id (e.g. `VaultId.AeraUsdAlpha` / `'gtusda'`) to\n * the Gaia API's CAIP-10 id for the vault's deployment on `chainId`.\n *\n * Deployment resolution is `resolveVault` \u2014 the same rules tx-building uses:\n * single-deployment vaults resolve directly (a mismatched explicit `chainId`\n * throws `ChainMismatchError`), multi-chain vaults default to Base when\n * `chainId` is omitted.\n */\nexport async function apiVaultIdFromVaultId(\n client: GauntletClient,\n vaultId: string,\n chainId?: number\n): Promise<string> {\n const resolved = await resolveVault(client, vaultId, chainId);\n if (!resolved) throw new VaultNotFoundError(vaultId, chainId);\n return formatApiVaultId(resolved.vault.chainId, resolved.vault.vaultAddress);\n}\n\n/**\n * Resolves a Gaia API CAIP-10 vault id back to the manifest vault id, or\n * `undefined` when the vault is not in the bundled manifest (the API indexes\n * more vaults than the manifest lists).\n */\nexport async function vaultIdFromApiVaultId(\n client: GauntletClient,\n apiVaultId: string\n): Promise<string | undefined> {\n const { chainId, address } = parseApiVaultId(apiVaultId);\n const manifest = await client.manifest;\n return manifest.vaults.find((v) =>\n v.deployments.some(\n (d) => d.chain === 'evm' && d.chainId === chainId && d.vaultAddress.toLowerCase() === address\n )\n )?.vaultId;\n}\n", "import { GauntletSDKError } from '../errors';\nimport type { ActivityOptions, GauntletApi, TokenRef, UserActivity } from './client';\nimport { decimalToBigInt, sharesToBigInt } from './decimal';\nimport { SettlementTimeoutError } from './errors';\n\nexport type ActivityFlowKind = 'deposit' | 'withdraw' | 'transfer_in' | 'transfer_out';\nexport type ActivityFlowStatus = 'settled' | 'pending' | 'refunded';\n\n/** A signed token amount as reported by the API, with base-unit conversion when possible. */\nexport interface AssetAmount {\n /** Human-unit decimal string exactly as the API emits it, e.g. `\"1250.5\"`. */\n decimal: string;\n /** Base-unit integer (`decimal \u00D7 10^token.decimals`); null when the token's decimals are unknown. */\n raw: bigint | null;\n token: TokenRef | null;\n}\n\n/**\n * One user action against a vault, stitched from the activity log's immutable\n * rows. Sync flows (Morpho, secondary-market transfers) come from a single\n * row; Aera async flows pair a `*_pending` request row with its terminal\n * settle/refund row via `request_hash`.\n */\nexport interface ActivityFlow {\n kind: ActivityFlowKind;\n status: ActivityFlowStatus;\n /** CAIP-10 vault id (`\"{chainId}:{address}\"`). */\n vaultId: string;\n /** Aera async correlation hash; null for sync flows and transfers. */\n requestHash: string | null;\n /** When the request row landed. Null when the flow's pending row is outside the fetched window. */\n requestedAt: Date | null;\n /** When the terminal (settle/refund) row landed. Null while pending. */\n settledAt: Date | null;\n /** Magnitude of the flow's asset movement (requested amount for refunded flows). */\n assets: AssetAmount;\n /** Magnitude of the flow's share movement in 18-decimal base units. */\n shares: bigint;\n /** Transaction hashes in row order (request first, then settlement, when both are known). */\n txHashes: string[];\n}\n\nconst PENDING_TYPES = new Set(['deposit_pending', 'withdraw_pending']);\nconst REFUNDED_TYPES = new Set(['deposit_refunded', 'withdraw_refunded']);\n\nfunction flowKind(rowType: string): ActivityFlowKind {\n if (rowType.startsWith('deposit')) return 'deposit';\n if (rowType.startsWith('withdraw')) return 'withdraw';\n if (rowType === 'transfer_in' || rowType === 'transfer_out') return rowType;\n throw new GauntletSDKError(`Unknown activity row type \"${rowType}\"`);\n}\n\nfunction abs(value: bigint): bigint {\n return value < 0n ? -value : value;\n}\n\n/**\n * Comparison scale for asset amounts. The API emits human-unit decimal strings\n * with at most `token.decimals` fractional digits, so 18 digits is exact for\n * every supported asset.\n */\nconst ASSET_SCALE = 18;\n\nfunction toAssetAmount(rows: UserActivity[]): AssetAmount {\n // Per the API contract, at most one row of an async lifecycle carries the\n // asset movement (the other legs are \"0\"), so the max magnitude is the\n // flow's amount. For refunded flows this surfaces the requested amount\n // instead of the useless net of zero.\n let best = rows[0];\n let bestMagnitude = abs(decimalToBigInt(best.assets_delta.native, ASSET_SCALE));\n for (const row of rows.slice(1)) {\n const magnitude = abs(decimalToBigInt(row.assets_delta.native, ASSET_SCALE));\n if (magnitude > bestMagnitude) {\n best = row;\n bestMagnitude = magnitude;\n }\n }\n const token =\n best.assets_delta.token ?? rows.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;\n const decimal = best.assets_delta.native.replace(/^-/, '');\n const raw = token?.decimals != null ? decimalToBigInt(decimal, token.decimals) : null;\n return { decimal, raw, token };\n}\n\n/**\n * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in\n * any order and may span multiple vaults; async lifecycles are paired by\n * `request_hash`. Flows are returned newest-first (by the flow's latest row).\n */\nexport function stitchActivityFlows(rows: UserActivity[]): ActivityFlow[] {\n const groups = new Map<string, UserActivity[]>();\n for (const [index, row] of rows.entries()) {\n // Rows without a request_hash are standalone sync flows: each one is its\n // own group, so two same-type events in one transaction (e.g. a multicall\n // doing two deposits) stay two flows.\n const key = row.request_hash ?? `row:${index}`;\n const group = groups.get(key);\n if (group) group.push(row);\n else groups.set(key, [row]);\n }\n\n const flows: ActivityFlow[] = [];\n for (const group of groups.values()) {\n group.sort((a, b) => a.block_timestamp - b.block_timestamp);\n const pendingRow = group.find((r) => PENDING_TYPES.has(r.type)) ?? null;\n const terminalRow = group.find((r) => !PENDING_TYPES.has(r.type)) ?? null;\n const isAsync = group.some((r) => r.request_hash != null);\n\n let status: ActivityFlowStatus;\n if (!terminalRow) status = 'pending';\n else if (REFUNDED_TYPES.has(terminalRow.type)) status = 'refunded';\n else status = 'settled';\n\n let sharesMagnitude = 0n;\n for (const row of group) {\n const shares = abs(sharesToBigInt(row.shares_delta));\n if (shares > sharesMagnitude) sharesMagnitude = shares;\n }\n\n flows.push({\n kind: flowKind((terminalRow ?? pendingRow ?? group[0]).type),\n status,\n vaultId: group[0].vault_id,\n requestHash: group[0].request_hash ?? null,\n requestedAt: pendingRow\n ? new Date(pendingRow.block_timestamp * 1000)\n : isAsync\n ? null\n : new Date(group[0].block_timestamp * 1000),\n settledAt: terminalRow ? new Date(terminalRow.block_timestamp * 1000) : null,\n assets: toAssetAmount(group),\n shares: sharesMagnitude,\n txHashes: [...new Set(group.map((r) => r.tx_hash))],\n });\n }\n\n return flows.sort((a, b) => {\n const aAt = (a.settledAt ?? a.requestedAt)?.getTime() ?? 0;\n const bAt = (b.settledAt ?? b.requestedAt)?.getTime() ?? 0;\n return bAt - aAt;\n });\n}\n\nexport interface ActivityFlowsOptions extends Pick<ActivityOptions, 'vaultId' | 'limit'> {\n /** Stop paginating once this many rows have been fetched. Defaults to 1000. */\n maxRows?: number;\n}\n\n/**\n * Fetches the wallet's activity log and stitches it into lifecycle-aware\n * flows \u2014 the replacement for scanning vault event logs over RPC.\n *\n * ```ts\n * const flows = await getActivityFlows(client.api, wallet);\n * const open = flows.filter((f) => f.status === 'pending');\n * ```\n */\nexport async function getActivityFlows(\n api: GauntletApi,\n walletAddress: string,\n options: ActivityFlowsOptions = {}\n): Promise<ActivityFlow[]> {\n const maxRows = options.maxRows ?? 1000;\n const rows: UserActivity[] = [];\n for await (const row of api.activityRows(walletAddress, {\n vaultId: options.vaultId,\n // The API caps page size at 1000; request maxRows per page so the common\n // case is a single round trip instead of ten default-100 pages.\n limit: options.limit ?? Math.min(maxRows, 1000),\n order: 'desc',\n })) {\n rows.push(row);\n if (rows.length >= maxRows) break;\n }\n const flows = stitchActivityFlows(rows);\n if (rows.length >= maxRows) {\n // The window cut may have split an async lifecycle, keeping a terminal\n // row whose request leg (the one carrying the amount) fell outside the\n // window. Drop those flows rather than reporting zeroed amounts.\n return flows.filter((f) => f.requestHash === null || f.requestedAt !== null);\n }\n return flows;\n}\n\nexport interface WaitForSettlementOptions {\n /** CAIP-10 vault id \u2014 narrows polling to one vault's activity. */\n vaultId?: string;\n /** Polling interval. Defaults to 5s. */\n pollIntervalMs?: number;\n /** Overall deadline. Defaults to 10 minutes. Throws `SettlementTimeoutError` on expiry. */\n timeoutMs?: number;\n}\n\n/**\n * Polls the activity log until the Aera async request identified by\n * `requestHash` reaches a terminal state, and returns the settled or refunded\n * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.\n */\nexport async function waitForRequestSettlement(\n api: GauntletApi,\n walletAddress: string,\n requestHash: string,\n options: WaitForSettlementOptions = {}\n): Promise<ActivityFlow> {\n const pollIntervalMs = options.pollIntervalMs ?? 5_000;\n const timeoutMs = options.timeoutMs ?? 600_000;\n const deadline = Date.now() + timeoutMs;\n\n for (;;) {\n const flows = await getActivityFlows(api, walletAddress, { vaultId: options.vaultId });\n const flow = flows.find((f) => f.requestHash === requestHash);\n if (flow && flow.status !== 'pending') return flow;\n\n if (Date.now() + pollIntervalMs > deadline) {\n throw new SettlementTimeoutError(requestHash, timeoutMs);\n }\n await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n }\n}\n", "import { GauntletSDKError } from '../errors';\nimport type { GauntletApi, TokenRef, UserActivity } from './client';\nimport { bigIntToDecimal, decimalToBigInt, sharesToBigInt } from './decimal';\n\n/**\n * Internal accounting scale for asset amounts. The API emits human-unit\n * decimal strings with at most `token.decimals` fractional digits, so 18\n * digits is exact for every supported asset; a token with more than 18\n * decimals would throw `DecimalPrecisionError` rather than lose precision.\n */\nconst ASSET_SCALE = 18;\n\n/** The wallet's reconstructed position state immediately after one activity row. */\nexport interface PositionHistoryPoint {\n timestamp: Date;\n txHash: string;\n type: UserActivity['type'];\n /** Signed share movement of this row, 18-decimal base units. */\n sharesDelta: bigint;\n /** Signed asset movement of this row (deposit-ledger convention), human decimal string. */\n assetsDelta: string;\n /** Shares held by the wallet after this row (escrowed redeem shares excluded). */\n sharesBalance: bigint;\n /** Assets escrowed at the Provisioner awaiting share mint, human decimal string. */\n pendingDepositAssets: string;\n /** Shares escrowed at the Provisioner awaiting asset return, 18-decimal base units. */\n pendingRedeemShares: bigint;\n /** Cumulative settled deposits minus settled withdrawals, human decimal string. */\n netAssetsIn: string;\n}\n\nexport interface PositionHistory {\n /** CAIP-10 vault id the history belongs to. */\n vaultId: string;\n /** The vault's asset token, when the indexer reports it on any row. */\n token: TokenRef | null;\n /** Chronological (oldest-first) position states, one per activity row. */\n points: PositionHistoryPoint[];\n}\n\n/**\n * Pure builder: replays a single vault's activity rows (any order) into a\n * chronological position timeline \u2014 running share balance, escrowed pending\n * amounts, and cumulative net asset flows.\n *\n * Async lifecycles are paired via `request_hash` so settled deposits count\n * the requested asset amount and terminal rows release the matching escrow.\n */\nexport function buildPositionHistory(rows: UserActivity[]): PositionHistory {\n if (rows.length === 0) {\n throw new GauntletSDKError('Cannot build position history from zero activity rows');\n }\n const vaultIds = new Set(rows.map((r) => r.vault_id));\n if (vaultIds.size > 1) {\n throw new GauntletSDKError(\n `Position history requires rows from a single vault; got ${[...vaultIds].join(', ')}`\n );\n }\n\n const ordered = [...rows].sort((a, b) => a.block_timestamp - b.block_timestamp);\n const token = ordered.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;\n\n let sharesBalance = 0n;\n let pendingDepositAssets = 0n;\n let pendingRedeemShares = 0n;\n let netAssetsIn = 0n;\n const pendingDepositByHash = new Map<string, bigint>();\n const pendingRedeemByHash = new Map<string, bigint>();\n\n const points: PositionHistoryPoint[] = [];\n for (const row of ordered) {\n const sharesDelta = sharesToBigInt(row.shares_delta);\n const assetsDelta = decimalToBigInt(row.assets_delta.native, ASSET_SCALE);\n sharesBalance += sharesDelta;\n\n switch (row.type) {\n case 'deposit':\n if (row.request_hash != null) {\n // Async terminal solve: assets moved at request time; release escrow.\n const requested = pendingDepositByHash.get(row.request_hash);\n if (requested === undefined) {\n throw new GauntletSDKError(\n `Deposit settlement ${row.tx_hash} references request_hash \"${row.request_hash}\" with no matching deposit_pending row`\n );\n }\n pendingDepositByHash.delete(row.request_hash);\n pendingDepositAssets -= requested;\n netAssetsIn += requested;\n } else {\n netAssetsIn += assetsDelta;\n }\n break;\n case 'deposit_pending':\n pendingDepositAssets += assetsDelta;\n if (row.request_hash != null) pendingDepositByHash.set(row.request_hash, assetsDelta);\n break;\n case 'deposit_refunded':\n // Row carries the unwound request as a negative delta.\n pendingDepositAssets += assetsDelta;\n if (row.request_hash != null) pendingDepositByHash.delete(row.request_hash);\n break;\n case 'withdraw':\n // Sync withdraws and async terminal solves both carry the asset\n // payout as a negative delta on this row.\n netAssetsIn += assetsDelta;\n if (row.request_hash != null) {\n const escrowed = pendingRedeemByHash.get(row.request_hash);\n if (escrowed === undefined) {\n throw new GauntletSDKError(\n `Withdraw settlement ${row.tx_hash} references request_hash \"${row.request_hash}\" with no matching withdraw_pending row`\n );\n }\n pendingRedeemByHash.delete(row.request_hash);\n pendingRedeemShares -= escrowed;\n }\n break;\n case 'withdraw_pending': {\n const escrowed = -sharesDelta;\n pendingRedeemShares += escrowed;\n if (row.request_hash != null) pendingRedeemByHash.set(row.request_hash, escrowed);\n break;\n }\n case 'withdraw_refunded':\n pendingRedeemShares -= sharesDelta;\n if (row.request_hash != null) pendingRedeemByHash.delete(row.request_hash);\n break;\n case 'transfer_in':\n case 'transfer_out':\n break;\n default:\n throw new GauntletSDKError(`Unknown activity row type \"${row.type}\"`);\n }\n\n points.push({\n timestamp: new Date(row.block_timestamp * 1000),\n txHash: row.tx_hash,\n type: row.type,\n sharesDelta,\n assetsDelta: row.assets_delta.native,\n sharesBalance,\n pendingDepositAssets: bigIntToDecimal(pendingDepositAssets, ASSET_SCALE),\n pendingRedeemShares,\n netAssetsIn: bigIntToDecimal(netAssetsIn, ASSET_SCALE),\n });\n }\n\n return { vaultId: ordered[0].vault_id, token, points };\n}\n\n/**\n * Fetches a wallet's complete activity for one vault and replays it into a\n * position timeline. `vaultId` is the CAIP-10 id; use `apiVaultIdFromVaultId`\n * to convert a manifest vault id. A wallet that has never touched the vault\n * gets an empty timeline, not an error.\n */\nexport async function getPositionHistory(\n api: GauntletApi,\n walletAddress: string,\n vaultId: string\n): Promise<PositionHistory> {\n const rows: UserActivity[] = [];\n for await (const row of api.activityRows(walletAddress, { vaultId, order: 'asc', limit: 1000 })) {\n rows.push(row);\n }\n if (rows.length === 0) return { vaultId, token: null, points: [] };\n return buildPositionHistory(rows);\n}\n"],
5
- "mappings": "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",
6
- "names": ["ASSET_SCALE"]
7
- }