safehands-pharos 1.2.0 → 1.2.3

package/dist/lib/constants.d.ts

@@ -1,27 +1,142 @@
-export declare const RPC_URL = "https://atlantic.dplabs-internal.com/";
-export declare const CHAIN_ID = 688689;
-export declare const EXPLORER_BASE = "https://atlantic.pharosscan.xyz/tx/";
+export declare const PHAROS_ENVIRONMENT: string;
+export declare const CHAIN_ID: number;
+export declare const RPC_URL: string;
+export declare const EXPLORER_BASE: string;
+export declare const IS_MAINNET = false;
+export declare const CHAIN_REGISTRY: {
+    readonly pharosAtlanticTestnet: {
+        readonly environment: "atlantic-testnet";
+        readonly chainId: 688689;
+        readonly isMainnet: false;
+        readonly rpcUrlEnv: "PHAROS_RPC_URL";
+        readonly defaultRpcUrl: "https://atlantic.dplabs-internal.com/";
+        readonly explorerUrl: "https://atlantic.pharosscan.xyz/";
+        readonly docsSource: "https://docs.pharosnetwork.xyz/developer-guide/hardhat/write-your-first-nft";
+    };
+};
 /** Native PHRS — sentinel address used by DODO API for native token */
 export declare const PHRS_ADDRESS: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
 export declare const USDT_ADDRESS: "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5";
-export declare const USDC_ADDRESS: "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B";
+/** Primary USDC for Pharos Skill Engine (from official tokens.json) */
+export declare const USDC_ADDRESS: "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
+/** Alternate USDC listed by Circle's contract addresses page (not in Skill Engine tokens.json) */
+export declare const CIRCLE_USDC_ADDRESS: "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B";
+/** @deprecated Use USDC_ADDRESS instead. Kept for backward compatibility. */
+export declare const X402_DEMO_USDC_ADDRESS: "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
 export declare const TEST_USDC_ADDRESS: "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
 export declare const WBTC_ADDRESS: "0x0c64F03EEa5c30946D5c55B4b532D08ad74638a4";
 export declare const WETH_ADDRESS: "0x7d211F77525ea39A0592794f793cC1036eEaccD5";
 export declare const WPHRS_ADDRESS: "0x838800b758277CC111B2d48Ab01e5E164f8E9471";
+export declare const TOKEN_REGISTRY: {
+    readonly PHRS: {
+        readonly symbol: "PHRS";
+        readonly address: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+        readonly decimals: 18;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "native PHRS sentinel address for DODO route API";
+        readonly docsSource: "https://docs.pharos.xyz/";
+    };
+    readonly USDC: {
+        readonly symbol: "USDC";
+        readonly address: "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
+        readonly decimals: 6;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "Pharos Skill Engine USDC — the USDC listed in the official pharos-skill-engine-0.1.0 assets/tokens.json for atlantic-testnet";
+        readonly docsSource: "pharos-skill-engine-0.1.0/assets/tokens.json";
+        readonly verificationStatus: "DOCS_VERIFIED_FROM_PHAROS_SKILL_ENGINE";
+    };
+    readonly CIRCLE_USDC: {
+        readonly symbol: "CIRCLE_USDC";
+        readonly address: "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B";
+        readonly decimals: 6;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "Alternate USDC listed by Circle contract addresses page and Pharos docs token registry; not the primary token in Skill Engine tokens.json";
+        readonly docsSource: "https://developers.circle.com/stablecoins/usdc-contract-addresses and https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "CIRCLE_REFERENCED_USDC";
+    };
+    readonly USDT: {
+        readonly symbol: "USDT";
+        readonly address: "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5";
+        readonly decimals: 6;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "canonical Pharos Atlantic Testnet USDT (Tether USD)";
+        readonly docsSource: "https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "DOCS_VERIFIED";
+    };
+    readonly WBTC: {
+        readonly symbol: "WBTC";
+        readonly address: "0x0c64F03EEa5c30946D5c55B4b532D08ad74638a4";
+        readonly decimals: 18;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "canonical Pharos Atlantic Testnet WBTC (Wrapped BTC)";
+        readonly docsSource: "https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "DOCS_VERIFIED";
+    };
+    readonly WETH: {
+        readonly symbol: "WETH";
+        readonly address: "0x7d211F77525ea39A0592794f793cC1036eEaccD5";
+        readonly decimals: 18;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "canonical Pharos Atlantic Testnet WETH (Wrapped ETH)";
+        readonly docsSource: "https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "DOCS_VERIFIED";
+    };
+    readonly WPHRS: {
+        readonly symbol: "WPHRS";
+        readonly address: "0x838800b758277CC111B2d48Ab01e5E164f8E9471";
+        readonly decimals: 18;
+        readonly chainId: number;
+        readonly environment: string;
+        readonly isMainnet: false;
+        readonly isCanonical: true;
+        readonly isTestToken: true;
+        readonly purpose: "canonical Pharos Atlantic Testnet WPHRS (Wrapped PHRS)";
+        readonly docsSource: "https://docs.pharos.xyz/getting-started/token-registry";
+        readonly verificationStatus: "DOCS_VERIFIED";
+    };
+};
 export declare const TOKEN_DECIMALS: Record<string, number>;
 export declare const TOKEN_MAP: Record<string, `0x${string}`>;
 export declare const DODO_APPROVE_ADDRESS: "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9";
 export declare const DODO_ROUTE_PROXY_ADDRESS: "0x819829e5CF6e19F9fED92F6b4CC1edF45a2cC4A2";
 export declare const POSITION_MANAGER_ADDRESS: "0x1c430d84DD6185b1Ea2d4693e0033799d193542f";
-export declare const DODO_API_BASE = "https://api.dodoex.io";
-export declare const DODO_API_KEY: string;
+export declare const DODO_API_BASE: string;
+export declare const DODO_API_KEY: string | undefined;
 export declare const DODO_DEFAULT_SLIPPAGE = 3.225;
 export declare const DODO_ROUTE_ENDPOINT = "/route-service/v2/widget/getdodoroute";
 export declare const RISK_BLOCK_THRESHOLD = 80;
 export declare const RISK_WARN_THRESHOLD = 60;
 export declare const MAX_SLIPPAGE_PCT = 5;
 export declare const MAX_BALANCE_USAGE_PCT = 90;
+export declare const MAX_TX_AMOUNT_PHRS: string;
+export declare const MAX_APPROVAL_AMOUNT_USDC: string;
+export declare const MAX_DAILY_SPEND_USD: string;
+export declare const MAX_X402_PAYMENT_USDC: string;
+export declare const X402_PAYMENT_TOKEN_ADDRESS: `0x${string}`;
 export declare const RISK_WEIGHTS: {
     readonly liquidityRisk: 0.25;
     readonly slippageRisk: 0.25;
@@ -105,7 +220,7 @@ export declare const ERC20_ABI: readonly [{
         readonly type: "bool";
     }];
 }];
-export declare const RISK_REGISTRY_ADDRESS: "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+export declare const RISK_REGISTRY_ADDRESS: `0x${string}`;
 export declare const RISK_REGISTRY_ABI: readonly [{
     readonly name: "publish";
     readonly type: "function";

package/dist/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,0CAA0C,CAAC;AAC/D,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,aAAa,wCAAwC,CAAC;AAInE,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,iBAAiB,EAAG,4CAAqD,CAAC;AACvF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,aAAa,EAAG,4CAAqD,CAAC;AAInF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAejD,CAAC;AAIF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAQnD,CAAC;AAIF,eAAO,MAAM,oBAAoB,EAAG,4CAAqD,CAAC;AAC1F,eAAO,MAAM,wBAAwB,EAAG,4CAAqD,CAAC;AAC9F,eAAO,MAAM,wBAAwB,EAAG,4CAAqD,CAAC;AAI9F,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,YAAY,QAAmD,CAAC;AAC7E,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAI3E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAIxC,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAIX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDZ,CAAC;AAIX,eAAO,MAAM,qBAAqB,EAAG,4CAAqD,CAAC;AAE3F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CpB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,kBAAkB,QAAuD,CAAC;AACvF,eAAO,MAAM,QAAQ,QAAkD,CAAC;AACxE,eAAO,MAAM,OAAO,QAAwE,CAAC;AAC7F,eAAO,MAAM,aAAa,QAA4E,CAAC;AACvG,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC;AASX,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAElF,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAElF,kGAAkG;AAClG,eAAO,MAAM,mBAAmB,EAAG,4CAAqD,CAAC;AAEzF,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,8CAAe,CAAC;AACnD,eAAO,MAAM,iBAAiB,8CAAe,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,YAAY,EAAG,4CAAqD,CAAC;AAClF,eAAO,MAAM,aAAa,EAAG,4CAAqD,CAAC;AAEnF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FjB,CAAC;AAIX,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAejD,CAAC;AAIF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAQnD,CAAC;AAIF,eAAO,MAAM,oBAAoB,EAAG,4CAAqD,CAAC;AAC1F,eAAO,MAAM,wBAAwB,EAAG,4CAAqD,CAAC;AAC9F,eAAO,MAAM,wBAAwB,EAAG,4CAAqD,CAAC;AAI9F,eAAO,MAAM,aAAa,QAAuD,CAAC;AAClF,eAAO,MAAM,YAAY,oBAA2B,CAAC;AACrD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAI3E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAIxC,eAAO,MAAM,kBAAkB,QAA0C,CAAC;AAC1E,eAAO,MAAM,wBAAwB,QAA+C,CAAC;AACrF,eAAO,MAAM,mBAAmB,QAA0C,CAAC;AAC3E,eAAO,MAAM,qBAAqB,QAA8C,CAAC;AACjF,eAAO,MAAM,0BAA0B,EAA+D,KAAK,MAAM,EAAE,CAAC;AAIpH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAIX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDZ,CAAC;AAIX,eAAO,MAAM,qBAAqB,EACiB,KAAK,MAAM,EAAE,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CpB,CAAC"}

package/dist/lib/constants.js

@@ -1,33 +1,152 @@
 // ─── SafeHands Constants ───────────────────────────────────────────────
-// All contract addresses, token configs, and protocol constants for
-// Pharos Atlantic Testnet (Chain ID: 688689)
+// Pharos Atlantic Testnet defaults. Values are labeled as testnet-only.
+// Official references reviewed during QA:
+// - Pharos Hardhat guide: Atlantic Testnet chain ID 688689, RPC https://atlantic.dplabs-internal.com
+// - Official Pharos Skill Engine tokens.json: USDC = 0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8
+// - Circle USDC contract addresses page: Pharos Testnet = 0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B
+// - For Pharos Skill Engine compatibility, SafeHands defaults to the Skill Engine token list.
 // ────────────────────────────────────────────────────────────────────────
 // ─── Network ───────────────────────────────────────────────────────────
-export const RPC_URL = "https://atlantic.dplabs-internal.com/";
-export const CHAIN_ID = 688689;
-export const EXPLORER_BASE = "https://atlantic.pharosscan.xyz/tx/";
+export const PHAROS_ENVIRONMENT = process.env.PHAROS_ENVIRONMENT || "atlantic-testnet";
+export const CHAIN_ID = Number(process.env.PHAROS_CHAIN_ID || "688689");
+export const RPC_URL = process.env.PHAROS_RPC_URL || "https://atlantic.dplabs-internal.com/";
+export const EXPLORER_BASE = process.env.PHAROS_EXPLORER_BASE || "https://atlantic.pharosscan.xyz/tx/";
+export const IS_MAINNET = false;
+export const CHAIN_REGISTRY = {
+    pharosAtlanticTestnet: {
+        environment: "atlantic-testnet",
+        chainId: 688689,
+        isMainnet: false,
+        rpcUrlEnv: "PHAROS_RPC_URL",
+        defaultRpcUrl: "https://atlantic.dplabs-internal.com/",
+        explorerUrl: "https://atlantic.pharosscan.xyz/",
+        docsSource: "https://docs.pharosnetwork.xyz/developer-guide/hardhat/write-your-first-nft",
+    },
+};
 // ─── Token Addresses ───────────────────────────────────────────────────
+// The official Pharos Skill Engine (pharos-skill-engine-0.1.0) assets/tokens.json
+// lists 0xE0BE... as USDC for atlantic-testnet.
+// Circle's USDC contract addresses page lists 0xcfC8... for Pharos Testnet.
+// For Skill Engine hackathon compatibility, SafeHands defaults to the Skill Engine list.
+// Both addresses are documented; neither is deleted.
 /** Native PHRS — sentinel address used by DODO API for native token */
 export const PHRS_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
 export const USDT_ADDRESS = "0xE7E84B8B4f39C507499c40B4ac199B050e2882d5";
-export const USDC_ADDRESS = "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B"; // Canonical USDC
-export const TEST_USDC_ADDRESS = "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8"; // Test USDC (with FaroSwap liquidity)
+/** Primary USDC for Pharos Skill Engine (from official tokens.json) */
+export const USDC_ADDRESS = "0xE0BE08c77f415F577A1B3A9aD7a1Df1479564ec8";
+/** Alternate USDC listed by Circle's contract addresses page (not in Skill Engine tokens.json) */
+export const CIRCLE_USDC_ADDRESS = "0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B";
+/** @deprecated Use USDC_ADDRESS instead. Kept for backward compatibility. */
+export const X402_DEMO_USDC_ADDRESS = USDC_ADDRESS;
+export const TEST_USDC_ADDRESS = USDC_ADDRESS;
 export const WBTC_ADDRESS = "0x0c64F03EEa5c30946D5c55B4b532D08ad74638a4";
 export const WETH_ADDRESS = "0x7d211F77525ea39A0592794f793cC1036eEaccD5";
 export const WPHRS_ADDRESS = "0x838800b758277CC111B2d48Ab01e5E164f8E9471";
+export const TOKEN_REGISTRY = {
+    PHRS: {
+        symbol: "PHRS",
+        address: PHRS_ADDRESS,
+        decimals: 18,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "native PHRS sentinel address for DODO route API",
+        docsSource: "https://docs.pharos.xyz/",
+    },
+    USDC: {
+        symbol: "USDC",
+        address: USDC_ADDRESS,
+        decimals: 6,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "Pharos Skill Engine USDC — the USDC listed in the official pharos-skill-engine-0.1.0 assets/tokens.json for atlantic-testnet",
+        docsSource: "pharos-skill-engine-0.1.0/assets/tokens.json",
+        verificationStatus: "DOCS_VERIFIED_FROM_PHAROS_SKILL_ENGINE",
+    },
+    CIRCLE_USDC: {
+        symbol: "CIRCLE_USDC",
+        address: CIRCLE_USDC_ADDRESS,
+        decimals: 6,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "Alternate USDC listed by Circle contract addresses page and Pharos docs token registry; not the primary token in Skill Engine tokens.json",
+        docsSource: "https://developers.circle.com/stablecoins/usdc-contract-addresses and https://docs.pharos.xyz/getting-started/token-registry",
+        verificationStatus: "CIRCLE_REFERENCED_USDC",
+    },
+    USDT: {
+        symbol: "USDT",
+        address: USDT_ADDRESS,
+        decimals: 6,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "canonical Pharos Atlantic Testnet USDT (Tether USD)",
+        docsSource: "https://docs.pharos.xyz/getting-started/token-registry",
+        verificationStatus: "DOCS_VERIFIED",
+    },
+    WBTC: {
+        symbol: "WBTC",
+        address: WBTC_ADDRESS,
+        decimals: 18,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "canonical Pharos Atlantic Testnet WBTC (Wrapped BTC)",
+        docsSource: "https://docs.pharos.xyz/getting-started/token-registry",
+        verificationStatus: "DOCS_VERIFIED",
+    },
+    WETH: {
+        symbol: "WETH",
+        address: WETH_ADDRESS,
+        decimals: 18,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "canonical Pharos Atlantic Testnet WETH (Wrapped ETH)",
+        docsSource: "https://docs.pharos.xyz/getting-started/token-registry",
+        verificationStatus: "DOCS_VERIFIED",
+    },
+    WPHRS: {
+        symbol: "WPHRS",
+        address: WPHRS_ADDRESS,
+        decimals: 18,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        isCanonical: true,
+        isTestToken: true,
+        purpose: "canonical Pharos Atlantic Testnet WPHRS (Wrapped PHRS)",
+        docsSource: "https://docs.pharos.xyz/getting-started/token-registry",
+        verificationStatus: "DOCS_VERIFIED",
+    },
+};
 // ─── Token Decimals ────────────────────────────────────────────────────
 export const TOKEN_DECIMALS = {
     PHRS: 18,
     USDT: 6,
     USDC: 6,
-    TUSDC: 6,
+    CIRCLE_USDC: 6,
     WBTC: 18,
     WETH: 18,
     WPHRS: 18,
     [PHRS_ADDRESS.toLowerCase()]: 18,
     [USDT_ADDRESS.toLowerCase()]: 6,
     [USDC_ADDRESS.toLowerCase()]: 6,
-    [TEST_USDC_ADDRESS.toLowerCase()]: 6,
+    [CIRCLE_USDC_ADDRESS.toLowerCase()]: 6,
     [WBTC_ADDRESS.toLowerCase()]: 18,
     [WETH_ADDRESS.toLowerCase()]: 18,
     [WPHRS_ADDRESS.toLowerCase()]: 18,
@@ -37,7 +156,7 @@ export const TOKEN_MAP = {
     PHRS: PHRS_ADDRESS,
     USDT: USDT_ADDRESS,
     USDC: USDC_ADDRESS,
-    TUSDC: TEST_USDC_ADDRESS,
+    CIRCLE_USDC: CIRCLE_USDC_ADDRESS,
     WBTC: WBTC_ADDRESS,
     WETH: WETH_ADDRESS,
     WPHRS: WPHRS_ADDRESS,
@@ -47,8 +166,8 @@ export const DODO_APPROVE_ADDRESS = "0x4Cf317b8918FbE8A890c01eDAb7d548555Ac2cE9"
 export const DODO_ROUTE_PROXY_ADDRESS = "0x819829e5CF6e19F9fED92F6b4CC1edF45a2cC4A2";
 export const POSITION_MANAGER_ADDRESS = "0x1c430d84DD6185b1Ea2d4693e0033799d193542f";
 // ─── DODO API ──────────────────────────────────────────────────────────
-export const DODO_API_BASE = "https://api.dodoex.io";
-export const DODO_API_KEY = process.env.DODO_API_KEY || "a37546505892e1a952";
+export const DODO_API_BASE = process.env.DODO_API_BASE || "https://api.dodoex.io";
+export const DODO_API_KEY = process.env.DODO_API_KEY;
 export const DODO_DEFAULT_SLIPPAGE = 3.225;
 export const DODO_ROUTE_ENDPOINT = "/route-service/v2/widget/getdodoroute";
 // ─── Risk Engine Thresholds ────────────────────────────────────────────
@@ -56,6 +175,12 @@ export const RISK_BLOCK_THRESHOLD = 80;
 export const RISK_WARN_THRESHOLD = 60;
 export const MAX_SLIPPAGE_PCT = 5;
 export const MAX_BALANCE_USAGE_PCT = 90;
+// ─── Safety Limits ─────────────────────────────────────────────────────
+export const MAX_TX_AMOUNT_PHRS = process.env.MAX_TX_AMOUNT_PHRS || "0.1";
+export const MAX_APPROVAL_AMOUNT_USDC = process.env.MAX_APPROVAL_AMOUNT_USDC || "10";
+export const MAX_DAILY_SPEND_USD = process.env.MAX_DAILY_SPEND_USD || "10";
+export const MAX_X402_PAYMENT_USDC = process.env.MAX_X402_PAYMENT_USDC || "0.01";
+export const X402_PAYMENT_TOKEN_ADDRESS = (process.env.X402_PAYMENT_TOKEN_ADDRESS || USDC_ADDRESS);
 // ─── Risk Weights ──────────────────────────────────────────────────────
 export const RISK_WEIGHTS = {
     liquidityRisk: 0.25,
@@ -119,7 +244,8 @@ export const ERC20_ABI = [
     },
 ];
 // ─── Risk Registry Contract ────────────────────────────────────────────
-export const RISK_REGISTRY_ADDRESS = "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+export const RISK_REGISTRY_ADDRESS = (process.env.RISK_REGISTRY_ADDRESS ||
+    "0x61962a6c812ee9f57b207e1ea47c19ae70bb7141");
 export const RISK_REGISTRY_ABI = [
     {
         name: "publish",

package/dist/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"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"}

package/dist/lib/dodoApi.d.ts

@@ -10,6 +10,7 @@ export interface DodoRouteResponse {
         value: string | number;
         gasLimit: string | number;
     } | null;
+    message?: string;
 }
 export interface DodoQuote {
     amountOut: string;
@@ -21,6 +22,8 @@ export interface DodoQuote {
     to: string;
     approveAddress: string;
     routeAvailable: boolean;
+    sourceStatus: "ok" | "no_route_available" | "auth_required" | "unavailable";
+    usedApiKey: boolean;
     rawResponse: DodoRouteResponse;
 }
 /**
@@ -43,6 +46,17 @@ export declare function fromWei(weiInput: string | number, decimals: number): st
 /**
  * Fetches a swap route from the DODO aggregation API.
  */
+export declare function _getDodoRouteCore(params: {
+    fromToken: string;
+    toToken: string;
+    amountHuman: string;
+    walletAddress: string;
+    slippage?: number;
+}): Promise<DodoQuote>;
+/**
+ * Smart wrapper around _getDodoRouteCore that automatically falls back to alternative token sources
+ * (like Circle USDC) if the canonical tokens have no liquidity on the testnet.
+ */
 export declare function getDodoRoute(params: {
     fromToken: string;
     toToken: string;

package/dist/lib/dodoApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dodoApi.d.ts","sourceRoot":"","sources":["../../src/lib/dodoApi.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;KAC3B,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAKhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa3E;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2DrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIpD"}
+{"version":3,"file":"dodoApi.d.ts","sourceRoot":"","sources":["../../src/lib/dodoApi.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;KAC3B,GAAG,IAAI,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,IAAI,GAAG,oBAAoB,GAAG,eAAe,GAAG,aAAa,CAAC;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAKhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU3E;AAID;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,SAAS,CAAC,CA6FrB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqBrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIpD"}

package/dist/lib/dodoApi.js

@@ -2,7 +2,9 @@
 // Fetches swap routes from DODO's aggregation API for FaroSwap on
 // Pharos Atlantic Testnet.
 // ────────────────────────────────────────────────────────────────────────
-import { DODO_API_BASE, DODO_API_KEY, DODO_DEFAULT_SLIPPAGE, DODO_ROUTE_ENDPOINT, CHAIN_ID, TOKEN_MAP, TOKEN_DECIMALS, PHRS_ADDRESS, } from "./constants.js";
+import { isAddress } from "viem";
+import { DODO_API_BASE, DODO_API_KEY, DODO_DEFAULT_SLIPPAGE, DODO_ROUTE_ENDPOINT, CHAIN_ID, TOKEN_MAP, TOKEN_DECIMALS, PHRS_ADDRESS, USDC_ADDRESS, CIRCLE_USDC_ADDRESS, } from "./constants.js";
+import { fetchWithTimeoutAndRetry } from "./http.js";
 // ─── Helpers ───────────────────────────────────────────────────────────
 /**
  * Resolves a token symbol (e.g. "PHRS") or address to its on-chain address.
@@ -11,9 +13,9 @@ export function resolveTokenAddress(token) {
     const upper = token.toUpperCase();
     if (TOKEN_MAP[upper])
         return TOKEN_MAP[upper];
-    if (token.startsWith("0x") && token.length === 42)
+    if (isAddress(token))
         return token;
-    throw new Error(`Unknown token: ${token}`);
+    throw new Error(`INVALID_TOKEN_ADDRESS: Unknown token or invalid address: ${token}`);
 }
 /**
  * Resolves the decimal count for a token symbol or address.
@@ -25,12 +27,15 @@ export function resolveTokenDecimals(token) {
     const lower = token.toLowerCase();
     if (TOKEN_DECIMALS[lower] !== undefined)
         return TOKEN_DECIMALS[lower];
-    return 18; // default fallback
+    return 18; // unknown custom token fallback
 }
 /**
  * Converts a human-readable amount to wei string.
  */
 export function toWei(amount, decimals) {
+    if (!/^\d+(\.\d+)?$/.test(amount)) {
+        throw new Error(`INVALID_AMOUNT: ${amount}`);
+    }
     const [whole, frac = ""] = amount.split(".");
     const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
     return BigInt(whole + paddedFrac).toString();
@@ -41,12 +46,10 @@ export function toWei(amount, decimals) {
  */
 export function fromWei(weiInput, decimals) {
     const weiStr = String(weiInput);
-    // If the string already contains a decimal point, it's already human-readable
-    if (weiStr.includes(".")) {
+    if (weiStr.includes("."))
         return weiStr;
-    }
     const wei = BigInt(weiStr);
-    const divisor = BigInt(10 ** decimals);
+    const divisor = BigInt(10) ** BigInt(decimals);
     const whole = wei / divisor;
     const remainder = wei % divisor;
     if (remainder === 0n)
@@ -58,7 +61,12 @@ export function fromWei(weiInput, decimals) {
 /**
  * Fetches a swap route from the DODO aggregation API.
  */
-export async function getDodoRoute(params) {
+export async function _getDodoRouteCore(params) {
+    const trimmedApiKey = DODO_API_KEY?.trim();
+    const usedApiKey = Boolean(trimmedApiKey);
+    if (!isAddress(params.walletAddress)) {
+        throw new Error(`INVALID_WALLET_ADDRESS: ${params.walletAddress}`);
+    }
     const fromAddress = resolveTokenAddress(params.fromToken);
     const toAddress = resolveTokenAddress(params.toToken);
     const fromDecimals = resolveTokenDecimals(params.fromToken);
@@ -66,23 +74,43 @@ export async function getDodoRoute(params) {
     const amountInWei = toWei(params.amountHuman, fromDecimals);
     const slippage = params.slippage ?? DODO_DEFAULT_SLIPPAGE;
     const deadline = Math.floor(Date.now() / 1000) + 600;
-    const url = `${DODO_API_BASE}${DODO_ROUTE_ENDPOINT}` +
-        `?chainId=${CHAIN_ID}` +
-        `&fromTokenAddress=${fromAddress}` +
-        `&toTokenAddress=${toAddress}` +
-        `&fromAmount=${amountInWei}` +
-        `&userAddr=${params.walletAddress}` +
-        `&slippage=${slippage}` +
-        `&source=dodoV2AndMixWasm` +
-        `&estimateGas=true` +
-        `&apikey=${DODO_API_KEY}` +
-        `&deadLine=${deadline}`;
-    const response = await fetch(url);
+    const url = new URL(`${DODO_API_BASE}${DODO_ROUTE_ENDPOINT}`);
+    url.searchParams.set("chainId", String(CHAIN_ID));
+    url.searchParams.set("fromTokenAddress", fromAddress);
+    url.searchParams.set("toTokenAddress", toAddress);
+    url.searchParams.set("fromAmount", amountInWei);
+    url.searchParams.set("userAddr", params.walletAddress);
+    url.searchParams.set("slippage", String(slippage));
+    url.searchParams.set("source", "dodoV2AndMixWasm");
+    url.searchParams.set("estimateGas", "true");
+    // DODO/FaroSwap read-only route queries should prefer public mode when no
+    // API key is configured. Never hardcode a default credential. If the
+    // provider rejects public mode, surface a structured auth-required error
+    // at the tool layer.
+    if (trimmedApiKey) {
+        url.searchParams.set("apikey", trimmedApiKey);
+    }
+    url.searchParams.set("deadLine", String(deadline));
+    const response = await fetchWithTimeoutAndRetry(url, {
+        timeoutMs: 10_000,
+        retries: 2,
+        retryDelayMs: 300,
+    });
     if (!response.ok) {
-        throw new Error(`DODO API error: ${response.status} ${response.statusText}`);
+        if (response.status === 401 || response.status === 403) {
+            throw new Error(`DODO_API_AUTH_REQUIRED: DODO route API rejected public mode${usedApiKey ? " or provided key" : "; configure DODO_API_KEY if this endpoint requires authentication"}`);
+        }
+        if (response.status === 429) {
+            throw new Error(`DODO_API_RATE_LIMITED: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`DODO_API_UNAVAILABLE: ${response.status} ${response.statusText}`);
     }
     const json = (await response.json());
     if (!json.data || json.status !== 200) {
+        const message = (json.message || "").toLowerCase();
+        if (message.includes("api key") || message.includes("apikey") || message.includes("unauthorized") || message.includes("forbidden")) {
+            throw new Error(`DODO_API_AUTH_REQUIRED: DODO route API rejected public mode${usedApiKey ? " or provided key" : "; configure DODO_API_KEY if this endpoint requires authentication"}`);
+        }
         return {
             amountOut: "0",
             amountOutWei: "0",
@@ -93,6 +121,8 @@ export async function getDodoRoute(params) {
             to: "",
             approveAddress: "",
             routeAvailable: false,
+            sourceStatus: "no_route_available",
+            usedApiKey,
             rawResponse: json,
         };
     }
@@ -108,9 +138,35 @@ export async function getDodoRoute(params) {
         to: d.to,
         approveAddress: d.targetApproveAddr,
         routeAvailable: true,
+        sourceStatus: "ok",
+        usedApiKey,
         rawResponse: json,
     };
 }
+/**
+ * Smart wrapper around _getDodoRouteCore that automatically falls back to alternative token sources
+ * (like Circle USDC) if the canonical tokens have no liquidity on the testnet.
+ */
+export async function getDodoRoute(params) {
+    let quote = await _getDodoRouteCore(params);
+    if (!quote.routeAvailable) {
+        const fromUpper = params.fromToken.toUpperCase();
+        const toUpper = params.toToken.toUpperCase();
+        // Smart Fallback: If swapping TO canonical USDC failed, try Alternate Circle USDC
+        if (toUpper === "USDC" || toUpper === USDC_ADDRESS.toUpperCase()) {
+            const fallbackQuote = await _getDodoRouteCore({ ...params, toToken: CIRCLE_USDC_ADDRESS });
+            if (fallbackQuote.routeAvailable)
+                return fallbackQuote;
+        }
+        // Smart Fallback: If swapping FROM canonical USDC failed, try Alternate Circle USDC
+        if (fromUpper === "USDC" || fromUpper === USDC_ADDRESS.toUpperCase()) {
+            const fallbackQuote = await _getDodoRouteCore({ ...params, fromToken: CIRCLE_USDC_ADDRESS });
+            if (fallbackQuote.routeAvailable)
+                return fallbackQuote;
+        }
+    }
+    return quote;
+}
 /**
  * Checks whether a token is the native PHRS token.
  */