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

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @skate-org/amm-core-v2
 
+## 2.0.0-beta.3 — 2026-05-18
+
+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.
+
+- **`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.2 — 2026-05-17
+
+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`:

package/dist/adapter/skate.d.ts

@@ -5,6 +5,21 @@ export declare function hexToBase58(hexString: `0x${string}`): string;
 export declare function bytes32ToBase58(hexStr: string): string;
 export declare function evmAddressToBytes32(address: string): `0x${string}`;
 export declare function bytes32ToEvmAddress(bytes32: string): `0x${string}`;
+/**
+ * Decode the canonical SVM-side encoding of an EVM address back to its
+ * 0x-prefixed lowercase EVM form.
+ *
+ * SVM periphery contracts store cross-VM addresses (kernel pool, kernel
+ * factory, etc.) as base58 of the address left-padded to bytes32 — the
+ * "bytes32-base58" form produced at deploy time by
+ * `evmAddressToBytes32Base58`. SDK readers reverse it: base58-decode to
+ * 32 bytes, then truncate to the trailing 20-byte EVM address.
+ *
+ * Composition of two existing primitives, named for the common case so
+ * readers don't reinvent it. Any reader pulling an EVM address out of an
+ * SVM Anchor account should call this.
+ */
+export declare function svmBytes32Base58ToEvmAddress(value: string): `0x${string}`;
 export declare function toBase58(buffer: Buffer): string;
 export declare function bufferFromBase58(base58String: string): Buffer;
 export declare function toBytes32Address(rawAddress: string, vmType: VM): `0x${string}`;

package/dist/adapter/skate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skate.d.ts","sourceRoot":"","sources":["../../src/adapter/skate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAMhE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAG5D;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;AAmBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAKlE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAIlE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,MAAM,EAAE,CAc9E;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,KAAK,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAWpF"}
+{"version":3,"file":"skate.d.ts","sourceRoot":"","sources":["../../src/adapter/skate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAMhE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAG5D;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;AAmBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAKlE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAIlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEzE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,MAAM,EAAE,CAc9E;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,KAAK,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAWpF"}

package/dist/deployment/_notDeployed.d.ts

@@ -0,0 +1,5 @@
+import { EnvMode } from "../types";
+/** Shared "not yet deployed" guard for STAGING / PRODUCTION accessors.
+ *  `surface` distinguishes which side is missing (kernel / periphery / SVM). */
+export declare function notDeployed(scope: string, mode: Exclude<EnvMode, "DEV">, surface?: string): never;
+//# sourceMappingURL=_notDeployed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_notDeployed.d.ts","sourceRoot":"","sources":["../../src/deployment/_notDeployed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC;gFACgF;AAChF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAC7B,OAAO,SAAW,GACjB,KAAK,CAKP"}

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

@@ -11,9 +11,17 @@ export interface EvmPeripheryInfo {
     chain: string;
 }
 export interface SvmPeripheryInfo {
-    /** Periphery pool PDA (base58 string). */
+    /** Periphery pool state PDA (base58). */
     peripheryPool: string;
-    /** Periphery manager program address (base58 string). */
+    /** Pool-authority PDA (base58, signer-only — has no on-chain account). */
+    poolAuthority: string;
+    /** Dust PDA (base58). */
+    dust: string;
+    /** Pool token0 vault PDA (base58). */
+    poolToken0Vault: string;
+    /** Pool token1 vault PDA (base58). */
+    poolToken1Vault: string;
+    /** Periphery manager pubkey (base58). Matches the deploy-wide manager. */
     manager: string;
     /** SPL or Token-2022 program id for token0. */
     tokenProgramId0: string;

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

@@ -1 +1 @@
-{"version":3,"file":"_type_.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/_type_.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,KAAK,IAC1C,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACnC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,OAAO,EACP;IACE,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE;SAAG,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;KAAE,CAAC;CACvD,CACF,CAAC"}
+{"version":3,"file":"_type_.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/_type_.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,KAAK,IAC1C,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACnC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,OAAO,EACP;IACE,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE;SAAG,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;KAAE,CAAC;CACvD,CACF,CAAC"}

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":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,YA2B3B,CAAC"}
+{"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"}

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;;;;;iCAsBhE,CAAC;SApBX;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,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"}

package/dist/deployment/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./kernel";
 export * from "./periphery";
+export * from "./svm";
 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,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,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/deployment/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAkBjC,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAoBtF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAIjE,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAEhD;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAGtE"}
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/deployment/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAkBjC,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAoBtF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAIjE,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAGtE"}

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

@@ -1 +1 @@
-{"version":3,"file":"periphery.d.ts","sourceRoot":"","sources":["../../src/deployment/periphery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAO1C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,oBAAoB,EAAE,KAAK,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAWrE,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,mBAAmB,GAAG,IAAI,CAG5B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB"}
+{"version":3,"file":"periphery.d.ts","sourceRoot":"","sources":["../../src/deployment/periphery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAO1C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,oBAAoB,EAAE,KAAK,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAWrE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,mBAAmB,GAAG,IAAI,CAG5B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACZ,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB"}

package/dist/deployment/svm.d.ts

@@ -0,0 +1,56 @@
+import { CHAIN, EnvMode } from "../types";
+import type { SvmChain } from "../types/chain-vm";
+/** Deploy-wide SVM pubkeys. Per-pool addresses live in `SVM_POOLS_<mode>`
+ *  below; this struct holds the deploy-wide pieces shared across pools. */
+export interface SvmDeployment {
+    peripheryPoolProgramId: string;
+    actionBoxProgramId: string;
+    /** `action_box state_v3` PDA. One per deploy. */
+    actionBoxStateV3: string;
+    /** `task_ledger` PDA (replay bitmap). */
+    taskLedger: string;
+    /** Manager pubkey — also serves as gateway and task-ledger admin. */
+    manager: string;
+}
+export declare const SVM_DEPLOYMENT_DEV: Partial<Record<SvmChain, SvmDeployment>>;
+/** Returns `null` for an unregistered SvmChain in DEV; throws for
+ *  STAGING/PRODUCTION (no SVM deploy yet). */
+export declare function SvmDeploymentFor(chain: SvmChain, mode: EnvMode): SvmDeployment | null;
+/** Per-pool SVM addresses, keyed by `[poolKey][SvmChain]`. `poolKey` matches
+ *  the key used by `POOL_INFO_Dev` (e.g. "USDC_USDT").
+ *  - Adding a new SVM chain entry to an existing pool (e.g. Eclipse under
+ *    USDC_USDT) requires editing this map only — `aggregated/dev.ts` picks
+ *    it up automatically via the existing spread.
+ *  - Adding a brand-new pool requires a new key here AND a new pool object
+ *    in `aggregated/dev.ts` with `...SVM_POOLS_DEV.<key>` in its
+ *    `peripheryInfo`. */
+export declare const SVM_POOLS_DEV: {
+    USDC_USDT: {
+        901: {
+            peripheryPool: string;
+            poolAuthority: string;
+            dust: string;
+            poolToken0Vault: string;
+            poolToken1Vault: string;
+            manager: string;
+            tokenProgramId0: string;
+            tokenProgramId1: string;
+            token0: {
+                address: string;
+                symbol: string;
+                isNative: false;
+                decimal: number;
+                chainId: CHAIN.SOLANA;
+            };
+            token1: {
+                address: string;
+                symbol: string;
+                isNative: false;
+                decimal: number;
+                chainId: CHAIN.SOLANA;
+            };
+            chain: string;
+        };
+    };
+};
+//# sourceMappingURL=svm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svm.d.ts","sourceRoot":"","sources":["../../src/deployment/svm.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,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAQvE,CAAC;AAEF;8CAC8C;AAC9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,GACZ,aAAa,GAAG,IAAI,CAGtB;AAKD;;;;;;;yBAOyB;AACzB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B6C,CAAC"}

package/dist/index.cjs

@@ -42,8 +42,11 @@ __export(index_exports, {
   PeripheryDeploymentFor: () => PeripheryDeploymentFor,
   PeripheryEventEmitterAddress: () => PeripheryEventEmitterAddress,
   PeripheryManagerAddress: () => PeripheryManagerAddress,
+  SVM_DEPLOYMENT_DEV: () => SVM_DEPLOYMENT_DEV,
+  SVM_POOLS_DEV: () => SVM_POOLS_DEV,
   SdkError: () => SdkError,
   SkateGatewayAddress: () => SkateGatewayAddress,
+  SvmDeploymentFor: () => SvmDeploymentFor,
   TaskPhase: () => TaskPhase,
   VM: () => VM,
   addDelta: () => addDelta,
@@ -81,6 +84,7 @@ __export(index_exports, {
   mulDivRoundingUp: () => mulDivRoundingUp,
   normalizeMode: () => normalizeMode,
   skateAdapter: () => skate_exports,
+  svmBytes32Base58ToEvmAddress: () => svmBytes32Base58ToEvmAddress,
   toBase58: () => toBase58,
   toBytes32Address: () => toBytes32Address,
   vmTypeFromChain: () => vmTypeFromChain
@@ -230,6 +234,13 @@ var SdkError = class extends Error {
   }
 };
 
+// src/deployment/_notDeployed.ts
+function notDeployed(scope, mode, surface = "SDK v2") {
+  throw new SdkError(
+    `${scope}: ${surface} is not yet deployed to ${mode}; only DEV is wired today. Either pass mode="DEV" or wait for the v2 service to ship to ${mode}.`
+  );
+}
+
 // src/deployment/kernel.ts
 var KERNEL_MANAGER_Dev = "0x17B7207837e8884f7f687f1f4057751BDAf70a01";
 var KERNEL_EVENT_EMITTER_Dev = "0x8989b3ecb65f250ab7A0DC03589B0Cc8b8b04b81";
@@ -242,11 +253,6 @@ var KERNEL_CHAIN_BY_MODE = {
 function KernelChain(mode) {
   return KERNEL_CHAIN_BY_MODE[mode];
 }
-function notDeployed(scope, mode) {
-  throw new SdkError(
-    `${scope}: SDK v2 is not yet deployed to ${mode}; only DEV is wired today. Either pass mode="DEV" or wait for the v2 service to ship to ${mode}.`
-  );
-}
 function KernelManagerAddress(mode) {
   if (mode === "DEV") return KERNEL_MANAGER_Dev;
   return notDeployed("KernelManagerAddress", mode);
@@ -269,13 +275,8 @@ var PERIPHERY_DEV = {
     peripheryPoolImpl: "0x803ed7fa8934D4fe51A276cA02506b585cdb3eb4"
   }
 };
-function notDeployed2(scope, mode) {
-  throw new SdkError(
-    `${scope}: SDK v2 is not yet deployed to ${mode}; only DEV is wired today. Either pass mode="DEV" or wait for the v2 service to ship to ${mode}.`
-  );
-}
 function PeripheryDeploymentFor(chain, mode) {
-  if (mode !== "DEV") return notDeployed2("PeripheryDeploymentFor", mode);
+  if (mode !== "DEV") return notDeployed("PeripheryDeploymentFor", mode);
   return PERIPHERY_DEV[chain] ?? null;
 }
 function PeripheryManagerAddress(chain, mode) {
@@ -291,6 +292,51 @@ function ActionBoxAddress(chain, mode) {
   return PeripheryDeploymentFor(chain, mode)?.actionBox ?? null;
 }
 
+// src/deployment/svm.ts
+var SVM_DEPLOYMENT_DEV = {
+  [901 /* SOLANA */]: {
+    peripheryPoolProgramId: "SPPZB76TV1oSusXvGYQDK7KZGyLBmWbr8CuzNcjb98y",
+    actionBoxProgramId: "SABZ2zgj8G8jD7V9s6hSMkT1fvNyMavssNigmmTMqa2",
+    actionBoxStateV3: "G1qLtJDbkY4JBtD7sdjqGN8GJ38QRDbzp2fWEYY4apAh",
+    taskLedger: "SkTLHEfy9X3PeMVa2dEYysg9Ccq8KtNG7zYNTAaB1NV",
+    manager: "SGMSTk5t2gmiHKQjtb9XV6qviasgD5UKTsVMHLGCSZA"
+  }
+};
+function SvmDeploymentFor(chain, mode) {
+  if (mode !== "DEV") return notDeployed("SvmDeploymentFor", mode, "SDK v2 SVM side");
+  return SVM_DEPLOYMENT_DEV[chain] ?? null;
+}
+var TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+var SVM_POOLS_DEV = {
+  USDC_USDT: {
+    [901 /* SOLANA */]: {
+      peripheryPool: "G2j8vLu3ryzUqPYpknpBcBLDcFiiRmXtB7z9Dpg9dVxe",
+      poolAuthority: "2Mvbo1TrsVeqyjQwNcdDDGjFNbwMk4tV8oD2TN2fV4Nw",
+      dust: "4m1AdUZvYJUSMTYpFH8df1JrgHTqUeKA3Xf7DapB4VcX",
+      poolToken0Vault: "BihGfVYmaT4KpiHiBLwH2ad9Q2ybYVHS2Bd3hQtzg486",
+      poolToken1Vault: "3DW4k4ims6dFB2cXBk5m1uAfh1zowuj9CzBbF4jm1FRh",
+      manager: "SGMSTk5t2gmiHKQjtb9XV6qviasgD5UKTsVMHLGCSZA",
+      tokenProgramId0: TOKEN_PROGRAM_ID,
+      tokenProgramId1: TOKEN_PROGRAM_ID,
+      token0: {
+        address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+        symbol: "USDC",
+        isNative: false,
+        decimal: 6,
+        chainId: 901 /* SOLANA */
+      },
+      token1: {
+        address: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
+        symbol: "USDT",
+        isNative: false,
+        decimal: 6,
+        chainId: 901 /* SOLANA */
+      },
+      chain: "SOLANA"
+    }
+  }
+};
+
 // src/deployment/aggregated/dev.ts
 var POOL_INFO_Dev = {
   USDC_USDT: {
@@ -316,7 +362,8 @@ var POOL_INFO_Dev = {
         },
         address: "0x0433CCB013a590eA4231aAC9ddf05bb753c14127",
         chain: "ARBITRUM"
-      }
+      },
+      ...SVM_POOLS_DEV.USDC_USDT
     }
   }
 };
@@ -448,6 +495,7 @@ __export(skate_exports, {
   evmAddressToBytes32: () => evmAddressToBytes32,
   fromBytes32Address: () => fromBytes32Address,
   hexToBase58: () => hexToBase58,
+  svmBytes32Base58ToEvmAddress: () => svmBytes32Base58ToEvmAddress,
   toBase58: () => toBase58,
   toBytes32Address: () => toBytes32Address
 });
@@ -582,6 +630,9 @@ function bytes32ToEvmAddress(bytes32) {
   const addressBigInt = userBigInt & BigInt("0xffffffffffffffffffffffffffffffffffffffff");
   return `0x${addressBigInt.toString(16).padStart(40, "0")}`.toLowerCase();
 }
+function svmBytes32Base58ToEvmAddress(value) {
+  return bytes32ToEvmAddress(base58ToBytes32(value));
+}
 function toBase58(buffer) {
   return bs58Encode(buffer);
 }
@@ -985,8 +1036,11 @@ function addDelta(x, y) {
   PeripheryDeploymentFor,
   PeripheryEventEmitterAddress,
   PeripheryManagerAddress,
+  SVM_DEPLOYMENT_DEV,
+  SVM_POOLS_DEV,
   SdkError,
   SkateGatewayAddress,
+  SvmDeploymentFor,
   TaskPhase,
   VM,
   addDelta,
@@ -1024,6 +1078,7 @@ function addDelta(x, y) {
   mulDivRoundingUp,
   normalizeMode,
   skateAdapter,
+  svmBytes32Base58ToEvmAddress,
   toBase58,
   toBytes32Address,
   vmTypeFromChain