@skate-org/amm-core-v2 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @skate-org/amm-core-v2
+
+## 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}`.

package/README.md

@@ -0,0 +1,32 @@
+# @skate-org/amm-core-v2
+
+Core types, deployment data, and the cross-VM adapter for the
+Skate AMM v2 SDK.
+
+Zero heavy runtime deps. Pure TypeScript.
+
+## Surface (high-level)
+
+- `CHAIN`, `VM`, `vmTypeFromChain`, `getBlockExplorer`
+- `EnvMode`, `DevModeConfig`, `EnvModeWithConfig`, `normalizeMode`
+- `Token`, `TokenPair`
+- `ActionStatus`, `TaskPhase`, `TaskFunctionMeta`
+- Kernel addresses: `KernelManagerAddress`, `KernelEventEmitterAddress`
+- Periphery deployment: `PERIPHERY_DEV`, `PeripheryManagerAddress`,
+  `PeripheryEventEmitterAddress`, `SkateGatewayAddress`, `ActionBoxAddress`
+- Pool tables: `POOL_INFO_Dev`, `POOL_INFO_Staging`, `POOL_INFO_Production`
+- Errors: `SdkError` (base for all package errors)
+
+## Install
+
+```bash
+pnpm add @skate-org/amm-core-v2
+```
+
+## Companion packages
+
+- [`@skate-org/amm-api-v2`](https://npmjs.com/package/@skate-org/amm-api-v2) — REST clients
+- [`@skate-org/amm-evm-v2`](https://npmjs.com/package/@skate-org/amm-evm-v2) — viem clients, readers, math
+- [`@skate-org/amm-v2`](https://npmjs.com/package/@skate-org/amm-v2) — umbrella
+
+See `CHANGELOG.md` for version history.

package/dist/adapter/index.d.ts

@@ -0,0 +1,3 @@
+export * as skateAdapter from "./skate";
+export * from "./skate";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,SAAS,CAAC;AACxC,cAAc,SAAS,CAAC"}

package/dist/adapter/skate.d.ts

@@ -0,0 +1,15 @@
+import { VM } from "../types";
+export declare function base58ToBytes32(base58Str: string): `0x${string}`;
+export declare function base58ToHex(base58Str: string): `0x${string}`;
+export declare function hexToBase58(hexString: `0x${string}`): string;
+export declare function bytes32ToBase58(hexStr: string): string;
+export declare const bytes32HexRegex: RegExp;
+export declare function isHexString(str: unknown): boolean;
+export declare function isHexStringLoose(str: unknown): boolean;
+export declare function evmAddressToBytes32(address: string): `0x${string}`;
+export declare function bytes32ToEvmAddress(bytes32: 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}`;
+export declare function fromBytes32Address(bytes32Address: `0x${string}`, vmType: VM): string;
+//# sourceMappingURL=skate.d.ts.map

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

@@ -0,0 +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;AAED,eAAO,MAAM,eAAe,QAA6B,CAAC;AAE1D,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,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"}

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

@@ -0,0 +1,13 @@
+import { TokenPair } from "../../types/pair";
+export type PoolKey = string;
+export type PoolInfoType = Record<PoolKey, {
+    kernelPool: `0x${string}`;
+    token0: string;
+    token1: string;
+    peripheryInfo: Record<number, TokenPair & {
+        address: `0x${string}` | string;
+        chain: string;
+    }>;
+    feeBps: number;
+}>;
+//# sourceMappingURL=_type_.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_type_.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/_type_.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,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,aAAa,EAAE,MAAM,CACnB,MAAM,EACN,SAAS,GAAG;QACV,OAAO,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;KACf,CACF,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB,CACF,CAAC"}

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

@@ -0,0 +1,3 @@
+import { PoolInfoType } from "./_type_";
+export declare const POOL_INFO_Dev: PoolInfoType;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,6 @@
+export * from "./_type_";
+export * from "./dev";
+export * from "./staging";
+export * from "./production";
+export * from "./retrieval";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+import { PoolInfoType } from "./_type_";
+export declare const POOL_INFO_Production: PoolInfoType;
+//# sourceMappingURL=production.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,26 @@
+import { CHAIN, EnvMode, Token, TokenPair } from "../../types";
+import { PoolInfoType, PoolKey } from "./_type_";
+export declare function getAllPoolInfo(mode?: EnvMode): PoolInfoType;
+export declare function getAllPoolKeys(mode?: EnvMode): PoolKey[];
+export declare function getPoolInfoByKey(key: PoolKey, mode?: EnvMode): {
+    kernelPool: `0x${string}`;
+    token0: string;
+    token1: string;
+    peripheryInfo: Record<number, TokenPair & {
+        address: `0x${string}` | string;
+        chain: string;
+    }>;
+    feeBps: number;
+} | null;
+export declare function getSupportedChains(mode?: EnvMode): CHAIN[];
+export declare function getSupportedPairs(chainId: CHAIN, mode?: EnvMode): (TokenPair & {
+    poolKey: PoolKey;
+})[];
+export declare function getSupportedTokens(chainId: CHAIN, mode?: EnvMode): Token[];
+export declare function getOtherTokensInPairs(chainId: CHAIN, tokenAddress: string, mode?: EnvMode): Token[];
+export declare function kernelPoolToPoolKey(kernelPool: `0x${string}`, mode?: EnvMode): PoolKey;
+export declare function getPeripheryDetailsByKernelPoolAndChainId(kernelPool: `0x${string}`, chainId: number, mode?: EnvMode): (TokenPair & {
+    address: `0x${string}` | string;
+    chain: string;
+}) | null;
+//# sourceMappingURL=retrieval.d.ts.map

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

@@ -0,0 +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;AAI/D,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;;;;;;;;;SAE1E;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,CACvD,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,OAAsB;;;UAK7B"}

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

@@ -0,0 +1,3 @@
+import { PoolInfoType } from "./_type_";
+export declare const POOL_INFO_Staging: PoolInfoType;
+//# sourceMappingURL=staging.d.ts.map

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

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

package/dist/deployment/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./kernel";
+export * from "./periphery";
+export * from "./aggregated";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/deployment/kernel.d.ts

@@ -0,0 +1,15 @@
+import { EnvMode } from "../types";
+export declare const KERNEL_EXECUTOR_REGISTRY_Dev = "0x45F5e211B2CAeA14d5E5cB028923F8A5D7b1ab5d";
+export declare const KERNEL_MESSAGE_BOX_Dev = "0xe3aC86bF5D9Ab5d9705b5e9187437e978397528B";
+export declare const KERNEL_ACCOUNT_REGISTRY_Dev = "0xeD9e139CAcb439744277be5D7fbEe5aAF4DB8fA2";
+export declare const KERNEL_MANAGER_Dev = "0x17B7207837e8884f7f687f1f4057751BDAf70a01";
+export declare const KERNEL_EVENT_EMITTER_Dev = "0x8989b3ecb65f250ab7A0DC03589B0Cc8b8b04b81";
+export declare const KERNEL_POOL_IMPL_Dev = "0x9BffA944Df7914621A7Cc638C9104C106c5C6846";
+export declare const KERNEL_POOL_USDC_USDT_Dev = "0x2c23334eE3b030e6bacEDEDf7C511eEA08Cf7E7e";
+export declare const KERNEL_MANAGER_Staging = "0xB32841DD65316F672eb07c63508f4b6841b6Aee4";
+export declare const KERNEL_EVENT_EMITTER_Staging = "0x8f16B23A11378bE8573470e23f626b9a7e41B389";
+export declare const KERNEL_MANAGER_Prod = "0x46887a1f9885300f4185499Ba48C248445EEcAb1";
+export declare const KERNEL_EVENT_EMITTER_Prod = "0xC8615dcE472fD684D0FDcEC18013EaB402F61ba7";
+export declare function KernelManagerAddress(mode?: EnvMode): `0x${string}`;
+export declare function KernelEventEmitterAddress(mode?: EnvMode): `0x${string}`;
+//# sourceMappingURL=kernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/deployment/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,eAAO,MAAM,4BAA4B,+CAA+C,CAAC;AACzF,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AACnF,eAAO,MAAM,2BAA2B,+CAA+C,CAAC;AACxF,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAC/E,eAAO,MAAM,wBAAwB,+CAA+C,CAAC;AACrF,eAAO,MAAM,oBAAoB,+CAA+C,CAAC;AACjF,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAItF,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AACnF,eAAO,MAAM,4BAA4B,+CAA+C,CAAC;AAGzF,eAAO,MAAM,mBAAmB,+CAA+C,CAAC;AAChF,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAEtF,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,MAAM,EAAE,CAMhF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,MAAM,EAAE,CAMrF"}

package/dist/deployment/periphery.d.ts

@@ -0,0 +1,20 @@
+import { CHAIN, EnvMode } from "../types";
+export interface PeripheryDeployment {
+    multicall: `0x${string}`;
+    executorRegistry: `0x${string}`;
+    actionBox: `0x${string}`;
+    skateGateway: `0x${string}`;
+    peripheryManager: `0x${string}`;
+    peripheryManagerImpl: `0x${string}`;
+    eventEmitter: `0x${string}`;
+    peripheryPoolImpl: `0x${string}`;
+}
+export declare const PERIPHERY_DEV: Partial<Record<CHAIN, PeripheryDeployment>>;
+export declare const PERIPHERY_STAGING: Partial<Record<CHAIN, PeripheryDeployment>>;
+export declare const PERIPHERY_PROD: Partial<Record<CHAIN, PeripheryDeployment>>;
+export declare function PeripheryDeploymentFor(chain: CHAIN, mode?: EnvMode): PeripheryDeployment | null;
+export declare function PeripheryManagerAddress(chain: CHAIN, mode?: EnvMode): `0x${string}` | null;
+export declare function PeripheryEventEmitterAddress(chain: CHAIN, mode?: EnvMode): `0x${string}` | null;
+export declare function SkateGatewayAddress(chain: CHAIN, mode?: EnvMode): `0x${string}` | null;
+export declare function ActionBoxAddress(chain: CHAIN, mode?: EnvMode): `0x${string}` | null;
+//# sourceMappingURL=periphery.d.ts.map

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

@@ -0,0 +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;AAM1C,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,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAM,CAAC;AACjF,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAM,CAAC;AAE9E,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,OAAsB,GAC3B,mBAAmB,GAAG,IAAI,CAI5B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,OAAsB,GAC3B,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,OAAsB,GAC3B,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,OAAsB,GAC3B,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,OAAsB,GAC3B,KAAK,MAAM,EAAE,GAAG,IAAI,CAEtB"}

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Base class for all errors originating from `@skate-org/amm-*` packages.
+ *
+ * Callers can use `err instanceof SdkError` to catch any SDK-origin failure
+ * without needing to know the specific subclass. Subclasses live in the
+ * package closest to their domain:
+ *
+ * - `ApiError` / `NotFoundError` / `NotImplementedError` — `@skate-org/amm-api-v2`
+ * - `EvmReadError` / `EvmWriteError` — `@skate-org/amm-evm-v2`
+ *
+ * Each subclass sets its own `.name`; this base only defines the identity.
+ */
+export declare class SdkError extends Error {
+    readonly name: string;
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAkB,IAAI,EAAE,MAAM,CAAc;gBAEhC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD"}