@skate-org/amm-core-v2 2.0.0-beta.0 → 2.0.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @skate-org/amm-core-v2
 
+## 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`:
+
+- **`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

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

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

@@ -19,4 +19,23 @@ export declare function getOtherTokensInPairs(chainId: CHAIN, tokenAddress: stri
 export declare function kernelPoolToPoolKey(kernelPool: `0x${string}`, mode?: EnvMode): PoolKey;
 export declare function getPeripheryDetailsByKernelPoolAndChainId<K extends CHAIN>(kernelPool: `0x${string}`, chainId: K, mode?: EnvMode): PeripheryInfoFor<K> | null;
 export declare function getPeripheryDetailsByKernelPoolAndChainId(kernelPool: `0x${string}`, chainId: number, mode?: EnvMode): PeripheryInfoFor<CHAIN> | null;
+/**
+ * Find tokens by case-insensitive symbol across one or more chains.
+ *
+ * Same token symbol on different chains has different addresses, so the
+ * return type is `Array<Token>` (not a single record) — the same
+ * `(symbol, chainId)` pair always points at one token, but
+ * `(symbol, chainIds[])` may produce many.
+ *
+ * Pass `chainIds` undefined / omitted to search every supported chain.
+ */
+export declare function findTokensBySymbol(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.
+ *
+ * Address comparison is case-insensitive; symbol is returned in the
+ * casing the deployment table records.
+ */
+export declare function getTokenSymbol(address: string, chainId: CHAIN, mode?: EnvMode): string | null;
 //# sourceMappingURL=retrieval.d.ts.map

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"}
+{"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,19 @@
+import { EnvMode } from "../types";
+import type { SvmChain } from "../types/chain-vm";
+/** Deploy-wide SVM pubkeys. Per-pool addresses live in
+ *  `POOL_INFO_<mode>[<key>].peripheryInfo[<chain>]`. */
+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;
+//# 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,EAAS,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;wDACwD;AACxD,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"}

package/dist/index.cjs

@@ -42,8 +42,10 @@ __export(index_exports, {
   PeripheryDeploymentFor: () => PeripheryDeploymentFor,
   PeripheryEventEmitterAddress: () => PeripheryEventEmitterAddress,
   PeripheryManagerAddress: () => PeripheryManagerAddress,
+  SVM_DEPLOYMENT_DEV: () => SVM_DEPLOYMENT_DEV,
   SdkError: () => SdkError,
   SkateGatewayAddress: () => SkateGatewayAddress,
+  SvmDeploymentFor: () => SvmDeploymentFor,
   TaskPhase: () => TaskPhase,
   VM: () => VM,
   addDelta: () => addDelta,
@@ -53,6 +55,7 @@ __export(index_exports, {
   bytes32ToBase58: () => bytes32ToBase58,
   bytes32ToEvmAddress: () => bytes32ToEvmAddress,
   evmAddressToBytes32: () => evmAddressToBytes32,
+  findTokensBySymbol: () => findTokensBySymbol,
   fromBytes32Address: () => fromBytes32Address,
   getAllPoolInfo: () => getAllPoolInfo,
   getAllPoolKeys: () => getAllPoolKeys,
@@ -73,12 +76,14 @@ __export(index_exports, {
   getSupportedPairs: () => getSupportedPairs,
   getSupportedTokens: () => getSupportedTokens,
   getTickAtSqrtRatio: () => getTickAtSqrtRatio,
+  getTokenSymbol: () => getTokenSymbol,
   hexToBase58: () => hexToBase58,
   kernelPoolToPoolKey: () => kernelPoolToPoolKey,
   mulDiv: () => mulDiv,
   mulDivRoundingUp: () => mulDivRoundingUp,
   normalizeMode: () => normalizeMode,
   skateAdapter: () => skate_exports,
+  svmBytes32Base58ToEvmAddress: () => svmBytes32Base58ToEvmAddress,
   toBase58: () => toBase58,
   toBytes32Address: () => toBytes32Address,
   vmTypeFromChain: () => vmTypeFromChain
@@ -228,6 +233,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";
@@ -240,11 +252,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);
@@ -267,13 +274,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) {
@@ -289,6 +291,21 @@ 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;
+}
+
 // src/deployment/aggregated/dev.ts
 var POOL_INFO_Dev = {
   USDC_USDT: {
@@ -314,6 +331,31 @@ var POOL_INFO_Dev = {
         },
         address: "0x0433CCB013a590eA4231aAC9ddf05bb753c14127",
         chain: "ARBITRUM"
+      },
+      [901 /* SOLANA */]: {
+        token0: {
+          address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+          symbol: "USDC",
+          isNative: false,
+          decimal: 6,
+          chainId: 901 /* SOLANA */
+        },
+        token1: {
+          address: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
+          symbol: "USDT",
+          isNative: false,
+          decimal: 6,
+          chainId: 901 /* SOLANA */
+        },
+        peripheryPool: "G2j8vLu3ryzUqPYpknpBcBLDcFiiRmXtB7z9Dpg9dVxe",
+        poolAuthority: "2Mvbo1TrsVeqyjQwNcdDDGjFNbwMk4tV8oD2TN2fV4Nw",
+        dust: "4m1AdUZvYJUSMTYpFH8df1JrgHTqUeKA3Xf7DapB4VcX",
+        poolToken0Vault: "BihGfVYmaT4KpiHiBLwH2ad9Q2ybYVHS2Bd3hQtzg486",
+        poolToken1Vault: "3DW4k4ims6dFB2cXBk5m1uAfh1zowuj9CzBbF4jm1FRh",
+        manager: "SGMSTk5t2gmiHKQjtb9XV6qviasgD5UKTsVMHLGCSZA",
+        tokenProgramId0: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+        tokenProgramId1: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+        chain: "SOLANA"
       }
     }
   }
@@ -411,6 +453,29 @@ function getPeripheryDetailsByKernelPoolAndChainId(kernelPool, chainId, mode = "
   const info = getAllPoolInfo(mode);
   return info[poolKey]?.peripheryInfo[chainId] ?? null;
 }
+function findTokensBySymbol(symbol, chainIds, mode = "PRODUCTION") {
+  const normalized = symbol.toLowerCase();
+  const chains = chainIds ?? getSupportedChains(mode);
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const chainId of chains) {
+    for (const t of getSupportedTokens(chainId, mode)) {
+      if (t.symbol.toLowerCase() !== normalized) continue;
+      const key = `${t.chainId}:${t.address.toLowerCase()}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      out.push(t);
+    }
+  }
+  return out;
+}
+function getTokenSymbol(address, chainId, mode = "PRODUCTION") {
+  const needle = address.toLowerCase();
+  for (const t of getSupportedTokens(chainId, mode)) {
+    if (t.address.toLowerCase() === needle) return t.symbol;
+  }
+  return null;
+}
 
 // src/adapter/skate.ts
 var skate_exports = {};
@@ -423,6 +488,7 @@ __export(skate_exports, {
   evmAddressToBytes32: () => evmAddressToBytes32,
   fromBytes32Address: () => fromBytes32Address,
   hexToBase58: () => hexToBase58,
+  svmBytes32Base58ToEvmAddress: () => svmBytes32Base58ToEvmAddress,
   toBase58: () => toBase58,
   toBytes32Address: () => toBytes32Address
 });
@@ -557,6 +623,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);
 }
@@ -960,8 +1029,10 @@ function addDelta(x, y) {
   PeripheryDeploymentFor,
   PeripheryEventEmitterAddress,
   PeripheryManagerAddress,
+  SVM_DEPLOYMENT_DEV,
   SdkError,
   SkateGatewayAddress,
+  SvmDeploymentFor,
   TaskPhase,
   VM,
   addDelta,
@@ -971,6 +1042,7 @@ function addDelta(x, y) {
   bytes32ToBase58,
   bytes32ToEvmAddress,
   evmAddressToBytes32,
+  findTokensBySymbol,
   fromBytes32Address,
   getAllPoolInfo,
   getAllPoolKeys,
@@ -991,12 +1063,14 @@ function addDelta(x, y) {
   getSupportedPairs,
   getSupportedTokens,
   getTickAtSqrtRatio,
+  getTokenSymbol,
   hexToBase58,
   kernelPoolToPoolKey,
   mulDiv,
   mulDivRoundingUp,
   normalizeMode,
   skateAdapter,
+  svmBytes32Base58ToEvmAddress,
   toBase58,
   toBytes32Address,
   vmTypeFromChain