@skate-org/amm-core-v2 2.0.0-beta.3 → 2.0.0-beta.7

package/CHANGELOG.md

@@ -1,214 +1,49 @@
 # @skate-org/amm-core-v2
 
-## 2.0.0-beta.3 — 2026-05-18
+## 2.0.0-beta.7 — 2026-05-21
 
-Internal refactor: per-pool SVM addresses consolidated into one file.
-No public type changes, no runtime data changes — `POOL_INFO_Dev` resolves
-to the same object shape it did in beta.2.
+Trimmed retired `0x9D62b2b6…` USDC_USDT entry from
+`deployment/aggregated/production.ts`. Doc baselines refreshed
+(`STABILITY.md`, `MIGRATION.md`, `CLAUDE.md`). No public surface
+change versus beta.6.
 
-- **`deployment/svm.ts` — new `SVM_POOLS_DEV` export:** map keyed by
-  `[poolKey][SvmChain]` (e.g. `SVM_POOLS_DEV.USDC_USDT[CHAIN.SOLANA]`)
-  carrying per-pool PDAs, vaults, mints, and token programs. Validated
-  at the declaration site via `satisfies Record<string, Partial<Record<
-  SvmChain, SvmPeripheryInfo>>>`. Additive, non-breaking — public surface
-  gains the export.
-- **`deployment/aggregated/dev.ts` — thin composition:**
-  `POOL_INFO_Dev.USDC_USDT.peripheryInfo` now spreads
-  `...SVM_POOLS_DEV.USDC_USDT` instead of inlining the SOLANA literal.
-  Adding a new SVM chain entry to an existing pool (e.g. Eclipse once it
-  deploys) is a one-file edit in `svm.ts`.
-- **`manager` field on `SvmPeripheryInfo`:** unchanged — duplication
-  against `SVM_DEPLOYMENT_DEV[chain].manager` is intentional and deferred
-  to a future PR; dedup would be a public-type change.
+## 2.0.0-beta (cumulative, 2026-05-07 → 2026-05-21)
 
-## 2.0.0-beta.2 — 2026-05-17
+Sum of beta.0 → beta.6. Surface set against which `2.0.0` final will
+be frozen.
 
-SVM-side periphery wired into the deployment catalog. Solana mainnet
-(chain_id 901) goes from "no deployment yet" to LIVE in DEV.
-
-- **`deployment/svm.ts` (new):** `SVM_DEPLOYMENT_DEV` table per
-  `SvmChain` carrying deploy-wide pubkeys — `periphery_pool` program,
-  `action_box` program, `action_box state_v3` PDA, `task_ledger` PDA,
-  manager — plus a `SvmDeploymentFor(chain, mode)` accessor that
-  mirrors the kernel/periphery `…For(chain, mode)` pattern. Solana
-  mainnet (chain_id 901) is populated; Eclipse still empty.
-  STAGING / PRODUCTION throw `SdkError("not yet deployed")`.
-- **`SvmPeripheryInfo` extended:** now carries the per-pool PDAs
-  (`peripheryPool`, `poolAuthority`, `dust`, `poolToken0Vault`,
-  `poolToken1Vault`) plus `manager` so builders can populate
-  `accountsStrict({...})` from the catalog without keypair math at
-  call time. `tokenProgramId0/1` / `token0/1` / `chain` carry over
-  from beta.1. Additive type change (existing fields kept).
-- **`POOL_INFO_Dev.USDC_USDT.peripheryInfo[CHAIN.SOLANA]`
-  populated** with the deployed `usdc-usdt-1bps` pool — PDAs and
-  vaults verified on-chain 2026-05-15 against the handover repo at
-  `/home/phil/works/handover/amm/solana_contracts/skate_amm/
-  config/pools.deployment.json`. Same kernel route as Arbitrum
-  periphery — Solana joins as an additional periphery for the same
-  kernel pool.
-- **Retrieval helpers** now report SOLANA alongside ARBITRUM:
-  `getSupportedChains("DEV")` returns `[CHAIN.SOLANA, CHAIN.ARBITRUM]`,
-  `findTokensBySymbol("USDC")` finds both the Arbitrum USDC ERC-20 and
-  the Solana USDC mint. Unit tests updated accordingly.
-- **`svmBytes32Base58ToEvmAddress(value)` (new export)** in
-  `adapter/skate.ts`. Composes `bytes32ToEvmAddress(base58ToBytes32(...))`
-  for the common case of decoding an SVM-stored EVM address
-  (`kernel_pool`, `kernel_factory`) back to its 0x-prefixed lowercase
-  form. Used by `@skate-org/amm-svm-v2`'s `readPeripheryPool`.
-
-## 2.0.0-beta.1 — 2026-05-07
-
-Two new token-lookup helpers in `deployment/aggregated/retrieval.ts`:
-
-- **`findTokensBySymbol(symbol, chainIds?, mode?)`** — search the
-  deployment catalog for tokens with a given symbol, optionally
-  filtered to specific chains. Symbol comparison is case-insensitive;
-  results are deduped by `(chainId, address)`. Pass `chainIds` as
-  `undefined` (or omit) to search every supported chain.
-- **`getTokenSymbol(address, chainId, mode?)`** — reverse lookup;
-  returns the token symbol at `(address, chainId)`, or `null` if no
-  supported token matches. Address comparison is case-insensitive.
-
-Both functions reuse the existing `getSupportedTokens` /
-`getSupportedChains` accessors so they automatically pick up new pools
-as the deployment table grows. 12 new unit tests covering case-
-insensitive matching, dedup behavior, mixed-valid/invalid `chainIds`,
-and unsupported-chain returns.
-
-## 2.0.0-beta.0 — 2026-05-07
-
-First **beta**. Promoted under the `beta` dist-tag; `latest` stays at
-`1.0.0` (v1 line) per the policy in `CLAUDE.md`. **Loose beta** —
-documented breaking changes are still allowed within `2.0.0-beta.x`;
-`2.0.0` final is the strict surface freeze.
-
-**Breaking — internal-leak surface pulls.** Symbols that were exported in
-the alpha line but never intended to be load-bearing have moved to module-
-private. Internal SDK callsites all have sanctioned replacements:
-
-- `KERNEL_EXECUTOR_REGISTRY_Dev`, `KERNEL_MESSAGE_BOX_Dev`,
+- **Surface pulls (beta.0):** removed alpha-era leaks
+  `KERNEL_EXECUTOR_REGISTRY_Dev`, `KERNEL_MESSAGE_BOX_Dev`,
   `KERNEL_ACCOUNT_REGISTRY_Dev`, `KERNEL_MANAGER_Dev`,
-  `KERNEL_EVENT_EMITTER_Dev`, `KERNEL_POOL_IMPL_Dev` removed. Use
-  `KernelManagerAddress(mode)` / `KernelEventEmitterAddress(mode)` /
-  `POOL_INFO_Dev`. `KERNEL_POOL_USDC_USDT_Dev` stays exported as a
-  smoke-test cross-check.
-- `PERIPHERY_PROD`, `PERIPHERY_STAGING` removed (were empty `{}`
-  placeholders). `PeripheryDeploymentFor(chain, mode)` now throws
-  `SdkError("…not yet deployed…")` for STAGING / PRODUCTION,
-  mirroring the kernel-side posture introduced in alpha.6.
-- `bytes32HexRegex`, `isHexString`, `isHexStringLoose` removed. Use
-  `evmAddressToBytes32` / `toBytes32Address`.
-- `PeripheryDeploymentFor` / `PeripheryManagerAddress` /
-  `PeripheryEventEmitterAddress` / `SkateGatewayAddress` /
-  `ActionBoxAddress` lost their default `mode = "PRODUCTION"` argument
-  — `mode` is now mandatory.
-
-Surface count: 73 → 62. See `STABILITY.md` (repo root) for the full
-per-package classification.
-
-## 2.0.0-alpha.8 — 2026-05-07
-
-Lockstep bump — paired with the api `streamSwapQuote` going live as a
-polling stub for the deferred WebSocket. This package's source is
-unchanged versus `2.0.0-alpha.7`.
-
-## 2.0.0-alpha.7 — 2026-05-07
-
-Lockstep bump — paired with the api action-by-user clients, polling
-`subscribeSwapQuote` helper, and svm browser-bundle build fix.
-This package's source is unchanged versus `2.0.0-alpha.6`.
-
-## 2.0.0-alpha.6 — 2026-05-07
-
-- **Per-env kernel chain config.** New `KERNEL_CHAIN_BY_MODE: Record<EnvMode, CHAIN>`
-  + `KernelChain(mode)` accessor. Defaults every env to `CHAIN.MEGAETH` today;
-  pointing a future env at a different kernel chain is a one-line edit.
-- **Breaking — `KernelManagerAddress` / `KernelEventEmitterAddress` throw on
-  STAGING / PRODUCTION.** Previously returned v1 Skate-chain placeholder
-  addresses (`0xB328…`, `0x4688…`) that don't exist on MegaETH; combined with
-  the kernel-chain hardcode, this caused silent reads from non-existent
-  contracts. Now both throw `SdkError("…not yet deployed to {mode}…")`. The
-  default `mode = "PRODUCTION"` argument is removed — callers must be explicit.
-
-## 2.0.0-alpha.5 — 2026-05-06
-
-Lockstep bump — paired with the kernel lens helpers ported into
-`@skate-org/amm-evm-v2`. This package's source is unchanged versus
-`2.0.0-alpha.4`.
-
-## 2.0.0-alpha.4 — 2026-05-06
-
-Lockstep bump — paired with the `SwapQuote` schema fix in
-`@skate-org/amm-api-v2`. This package's source is unchanged versus
-`2.0.0-alpha.3`.
-
-## 2.0.0-alpha.3 — 2026-05-06
-
-Lockstep bump — paired with the SVM/Sui efficiency pass in
-`@skate-org/amm-svm-v2` and `@skate-org/amm-sui-v2`. This package's
-source is unchanged versus `2.0.0-alpha.2`.
-
-## 2.0.0-alpha.2 — 2026-05-05
-
-Plan C of the SVM/Sui integration. Adds `@skate-org/amm-sui-v2` to
-the workspace; this package's source is unchanged versus
-`2.0.0-alpha.1` (re-versioned in lockstep).
-
-## 2.0.0-alpha.1 — 2026-05-05
-
-Plan B of the SVM/Sui integration. Adds `@skate-org/amm-svm-v2` to
-the workspace; this package's source is unchanged versus
-`2.0.0-alpha.0` (re-versioned in lockstep).
-
-## 2.0.0-alpha.0 — 2026-05-05
-
-Plan A of the SVM/Sui integration (see
-docs/superpowers/specs/2026-05-04-svm-sui-integration-design.md).
-
-- Add uniswap-v3 math module (`tickMath`, `sqrtPriceMath`,
-  `liquidityMath`, `fullMath`). Relocated from
-  `@skate-org/amm-evm-v2`.
-- Add `EvmChain` / `SvmChain` / `SuiChain` literal-union sub-types of
-  `CHAIN`.
-- **Breaking:** `PoolInfoType.peripheryInfo` is now a chain-id-
-  discriminated mapped type. EVM chain entries narrow to
-  `EvmPeripheryInfo`; SVM chain entries to `SvmPeripheryInfo`; Sui
-  to `SuiPeripheryInfo`. Code that read
-  `pool.peripheryInfo[chain].address` as `0x${string}` unconditionally
-  now type-narrows by chain.
-- New named types `EvmPeripheryInfo`, `SvmPeripheryInfo`,
-  `SuiPeripheryInfo`, `PeripheryInfoFor<K>`.
-- Cross-VM utilities (`base58ToBytes32`, `evmAddressToBytes32`,
-  `bytes32ToBase58`, `toBytes32Address`, `fromBytes32Address`)
-  unchanged in this release — already in core under
-  `adapter/skate.ts`.
-
-## 1.0.0 — 2026-05-04
-
-Realigning all four `@skate-org/amm-*-v2` packages at a single version
-for the coherent v1 SDK release. No source changes vs 0.4.0 — this is
-purely a versioning realignment so consumers can install
-`@skate-org/amm-core-v2@1`, `@skate-org/amm-api-v2@1`, `@skate-org/amm-evm-v2@1`,
-`@skate-org/amm-v2@1` and know they belong to the same release.
-
-## 0.4.0 — 2026-04-29
-
-- Add full DEV deployment table for Arbitrum periphery (`PERIPHERY_DEV`,
-  `PeripheryManagerAddress`, `PeripheryEventEmitterAddress`, `SkateGatewayAddress`,
-  `ActionBoxAddress`).
-- Add `KERNEL_EVENT_EMITTER_Dev` and tighten `KernelEventEmitterAddress` return
-  type from `| null` to `0x${string}`.
-- Wire `KERNEL_POOL_USDC_USDT_Dev` and the rest of the DEV kernel address constants.
-
-## 0.3.0 — 2026-04-25
-
-- Phase 4: shared `SdkError` base; cross-package error hierarchy.
-
-## 0.2.0 — 2026-04-22
-
-- Phase 3: full chain table + VM enum (`AptosVM` removed; `TEMPO 4217` added).
-
-## 0.1.0 — 2026-04-20
-
-- Initial: `CHAIN`, `VM`, `EnvMode*`, `Token`, `TokenPair`, `ActionStatus`,
-  `TaskPhase`, `KernelManagerAddress`, `POOL_INFO_{Dev,Staging,Production}`.
+  `KERNEL_EVENT_EMITTER_Dev`, `KERNEL_POOL_IMPL_Dev`,
+  `PERIPHERY_PROD`, `PERIPHERY_STAGING`, `bytes32HexRegex`,
+  `isHexString`, `isHexStringLoose`. Consumers move to
+  `KernelManagerAddress(mode)` / `PeripheryDeploymentFor(chain,
+  mode)` accessors.
+- **`findTokensBySymbol` / `getTokenSymbol` (beta.1, beta.6):**
+  added in beta.1 with positional args, switched to object input
+  `findTokensBySymbol({ symbol, chainIds?, mode? })` in beta.6 to
+  remove the awkward `findTokensBySymbol("USDC", undefined, "DEV")`
+  call shape. Loose-beta breaking change.
+- **SVM deployment catalog (beta.2, beta.3):** new
+  `SVM_DEPLOYMENT_DEV`, per-pool `SVM_POOLS_DEV`,
+  `SvmDeploymentFor(chain, mode)`. Solana mainnet
+  `usdc-usdt-1bps` periphery LIVE in DEV. Eclipse / STAGING /
+  PRODUCTION throw `SdkError("not yet deployed")`. New helper
+  `svmBytes32Base58ToEvmAddress` for decoding on-chain kernel-address
+  fields.
+- **Sui deployment catalog (beta.6):** new `SUI_POOLS_DEV` +
+  `SUI_DEPLOYMENT_DEV` + `SuiDeploymentFor(chain, mode)`. Sui
+  USDC/USDT periphery (`0xc014f7cb…`) wired to DEV kernel pool
+  `0x2c23334e…`.
+- **API ActionFields (beta.4):** v2-pure shape — flat `destChainId`
+  / `destVmType`, `peripheryFunctionMeta`, `poolInfo`; dropped v1
+  emulation fields (`legacyStatus`, flat tx-hash denorms, `tokens`,
+  `amounts`).
+- **Typed argument shapes (beta.5):** sibling exports `SwapArgs`,
+  `MintArgs`, `BurnArgs`, `DecreaseLiquidityArgs`.
+  `peripheryFunctionMeta.args` for `mint` / `increaseLiquidity` now
+  carries `liquidity` + `amount{0,1}Unused`.
+
+Surface count: 25 → 23 (one-time pull at beta.0). See
+`STABILITY.md` for the per-symbol classification.

package/dist/deployment/aggregated/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/dev.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,YA4B3B,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/dev.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,YA6B3B,CAAC"}

package/dist/deployment/aggregated/production.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/production.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,eAAO,MAAM,oBAAoB,EAAE,YAAiB,CAAC"}
+{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/production.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxC,eAAO,MAAM,oBAAoB,EAAE,YAAiB,CAAC"}

package/dist/deployment/aggregated/retrieval.d.ts

@@ -27,9 +27,13 @@ export declare function getPeripheryDetailsByKernelPoolAndChainId(kernelPool: `0
  * `(symbol, chainId)` pair always points at one token, but
  * `(symbol, chainIds[])` may produce many.
  *
- * Pass `chainIds` undefined / omitted to search every supported chain.
+ * Omit `chainIds` to search every supported chain.
  */
-export declare function findTokensBySymbol(symbol: string, chainIds?: readonly CHAIN[], mode?: EnvMode): Token[];
+export declare function findTokensBySymbol(args: {
+    symbol: string;
+    chainIds?: readonly CHAIN[];
+    mode?: EnvMode;
+}): Token[];
 /**
  * Reverse lookup: return the symbol of the token at `address` on
  * `chainId`, or `null` if no supported token matches that pair.

package/dist/deployment/aggregated/retrieval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,YAAY,CAMzE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,OAAO,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,OAAsB;;;;;iCAkClB,CAAA;SAhCxD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CASxE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,CAAC,SAAS,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CActC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CAcxF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAsB,GAC3B,KAAK,EAAE,CAeT;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,GAAE,OAAsB,GAAG,OAAO,CAOpG;AAED,wBAAgB,yCAAyC,CAAC,CAAC,SAAS,KAAK,EACvE,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAC9B,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AAWlC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,SAAS,KAAK,EAAE,EAC3B,IAAI,GAAE,OAAsB,GAC3B,KAAK,EAAE,CAeT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,MAAM,GAAG,IAAI,CAMf"}
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,YAAY,CAMzE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,OAAO,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,OAAsB;;;;;iCAkClB,CAAA;SAhCxD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CASxE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,CAAC,SAAS,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CActC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CAcxF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAsB,GAC3B,KAAK,EAAE,CAeT;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,GAAE,OAAsB,GAAG,OAAO,CAOpG;AAED,wBAAgB,yCAAyC,CAAC,CAAC,SAAS,KAAK,EACvE,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAC9B,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AAWlC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,KAAK,EAAE,CAgBV;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,MAAM,GAAG,IAAI,CAMf"}

package/dist/deployment/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./kernel";
 export * from "./periphery";
 export * from "./svm";
+export * from "./sui";
 export * from "./aggregated";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployment/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deployment/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}

package/dist/deployment/sui.d.ts

@@ -0,0 +1,42 @@
+import { CHAIN, EnvMode } from "../types";
+import type { SuiChain } from "../types/chain-vm";
+/** Deploy-wide Sui addresses. Per-pool object ids live in `SUI_POOLS_<mode>`
+ *  below; this struct holds the deploy-wide pieces shared across pools. */
+export interface SuiDeployment {
+    /** Sui package id that owns the periphery module. */
+    peripheryPackage: string;
+}
+export declare const SUI_DEPLOYMENT_DEV: Partial<Record<SuiChain, SuiDeployment>>;
+/** Returns `null` for an unregistered SuiChain in DEV; throws for
+ *  STAGING/PRODUCTION (no Sui deploy yet). */
+export declare function SuiDeploymentFor(chain: SuiChain, mode: EnvMode): SuiDeployment | null;
+/** Per-pool Sui addresses, keyed by `[poolKey][SuiChain]`. `poolKey` matches
+ *  the key used by `POOL_INFO_Dev` (e.g. "USDC_USDT"). Mirrors `SVM_POOLS_DEV`.
+ *  - Adding a brand-new pool requires a new key here AND a new pool object
+ *    in `aggregated/dev.ts` with `...SUI_POOLS_DEV.<key>` in its
+ *    `peripheryInfo`. */
+export declare const SUI_POOLS_DEV: {
+    USDC_USDT: {
+        1001: {
+            poolId: string;
+            managerCapId: string;
+            peripheryPackage: string;
+            token0: {
+                address: string;
+                symbol: string;
+                isNative: false;
+                decimal: number;
+                chainId: CHAIN.SUI;
+            };
+            token1: {
+                address: string;
+                symbol: string;
+                isNative: false;
+                decimal: number;
+                chainId: CHAIN.SUI;
+            };
+            chain: string;
+        };
+    };
+};
+//# sourceMappingURL=sui.d.ts.map

package/dist/deployment/sui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../src/deployment/sui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD;2EAC2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAKvE,CAAC;AAEF;8CAC8C;AAC9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,GACZ,aAAa,GAAG,IAAI,CAItB;AAED;;;;yBAIyB;AACzB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;CA4B6C,CAAC"}

package/dist/index.cjs

@@ -42,10 +42,13 @@ __export(index_exports, {
   PeripheryDeploymentFor: () => PeripheryDeploymentFor,
   PeripheryEventEmitterAddress: () => PeripheryEventEmitterAddress,
   PeripheryManagerAddress: () => PeripheryManagerAddress,
+  SUI_DEPLOYMENT_DEV: () => SUI_DEPLOYMENT_DEV,
+  SUI_POOLS_DEV: () => SUI_POOLS_DEV,
   SVM_DEPLOYMENT_DEV: () => SVM_DEPLOYMENT_DEV,
   SVM_POOLS_DEV: () => SVM_POOLS_DEV,
   SdkError: () => SdkError,
   SkateGatewayAddress: () => SkateGatewayAddress,
+  SuiDeploymentFor: () => SuiDeploymentFor,
   SvmDeploymentFor: () => SvmDeploymentFor,
   TaskPhase: () => TaskPhase,
   VM: () => VM,
@@ -337,6 +340,42 @@ var SVM_POOLS_DEV = {
   }
 };
 
+// src/deployment/sui.ts
+var SUI_DEPLOYMENT_DEV = {
+  [1001 /* SUI */]: {
+    peripheryPackage: "0x96e1d3897efee30bede047a14d186a952350d4759d3175f76ff6ac2c4a121901"
+  }
+};
+function SuiDeploymentFor(chain, mode) {
+  if (mode !== "DEV")
+    return notDeployed("SuiDeploymentFor", mode, "SDK v2 Sui side");
+  return SUI_DEPLOYMENT_DEV[chain] ?? null;
+}
+var SUI_POOLS_DEV = {
+  USDC_USDT: {
+    [1001 /* SUI */]: {
+      poolId: "0xc014f7cb0a2604fb887d09165242828e6fe913f30d7ae2bea80199caed5ccbcb",
+      managerCapId: "0xca34c6dff464f42a349294fa9fbe67a6d72eb999081db8de3fd56672b68863ee",
+      peripheryPackage: "0x96e1d3897efee30bede047a14d186a952350d4759d3175f76ff6ac2c4a121901",
+      token0: {
+        address: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
+        symbol: "USDC",
+        isNative: false,
+        decimal: 6,
+        chainId: 1001 /* SUI */
+      },
+      token1: {
+        address: "0x375f70cf2ae4c00bf37117d0c85a2c71545e6ee05c4a5c7d282cd66a4504b068::usdt::USDT",
+        symbol: "USDT",
+        isNative: false,
+        decimal: 6,
+        chainId: 1001 /* SUI */
+      },
+      chain: "SUI"
+    }
+  }
+};
+
 // src/deployment/aggregated/dev.ts
 var POOL_INFO_Dev = {
   USDC_USDT: {
@@ -363,7 +402,8 @@ var POOL_INFO_Dev = {
         address: "0x0433CCB013a590eA4231aAC9ddf05bb753c14127",
         chain: "ARBITRUM"
       },
-      ...SVM_POOLS_DEV.USDC_USDT
+      ...SVM_POOLS_DEV.USDC_USDT,
+      ...SUI_POOLS_DEV.USDC_USDT
     }
   }
 };
@@ -460,7 +500,8 @@ function getPeripheryDetailsByKernelPoolAndChainId(kernelPool, chainId, mode = "
   const info = getAllPoolInfo(mode);
   return info[poolKey]?.peripheryInfo[chainId] ?? null;
 }
-function findTokensBySymbol(symbol, chainIds, mode = "PRODUCTION") {
+function findTokensBySymbol(args) {
+  const { symbol, chainIds, mode = "PRODUCTION" } = args;
   const normalized = symbol.toLowerCase();
   const chains = chainIds ?? getSupportedChains(mode);
   const out = [];
@@ -1036,10 +1077,13 @@ function addDelta(x, y) {
   PeripheryDeploymentFor,
   PeripheryEventEmitterAddress,
   PeripheryManagerAddress,
+  SUI_DEPLOYMENT_DEV,
+  SUI_POOLS_DEV,
   SVM_DEPLOYMENT_DEV,
   SVM_POOLS_DEV,
   SdkError,
   SkateGatewayAddress,
+  SuiDeploymentFor,
   SvmDeploymentFor,
   TaskPhase,
   VM,