@pushchain/core 5.1.8 → 5.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "5.1.8",
+  "version": "5.1.9",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",

package/src/lib/orchestrator/internals/cascade.js

@@ -127,7 +127,7 @@ function buildHopDescriptor(ctx, params, route, ueaAddress) {
                     if ((_b = params.funds) === null || _b === void 0 ? void 0 : _b.amount) {
                         const token = params.funds.token;
                         if (token) {
-                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                             burnAmount = params.funds.amount;
                         }
                     }
@@ -233,7 +233,7 @@ function buildHopDescriptor(ctx, params, route, ueaAddress) {
                 if ((_f = params.funds) === null || _f === void 0 ? void 0 : _f.amount) {
                     const token = params.funds.token;
                     if (token) {
-                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                         burnAmount = params.funds.amount;
                     }
                 }
@@ -292,7 +292,7 @@ function buildHopDescriptor(ctx, params, route, ueaAddress) {
                         amount = params.funds.amount;
                         const token = params.funds.token;
                         if (token && token.address) {
-                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                         }
                         else {
                             prc20Token = (0, helpers_1.getNativePRC20ForChain)(sourceChain, ctx.pushNetwork);

package/src/lib/orchestrator/internals/route-handlers.js

@@ -62,7 +62,7 @@ function resolveR2Prc20TokenEvm(params, targetChain, pushNetwork) {
         // User explicitly specified funds with token
         const token = params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
             burnAmount = params.funds.amount;
         }
     }
@@ -90,7 +90,7 @@ function resolveR2Prc20TokenSvm(params, targetChain, pushNetwork, hasSvmExecute)
     if ((_a = params.funds) === null || _a === void 0 ? void 0 : _a.amount) {
         const token = params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
             burnAmount = params.funds.amount;
         }
     }
@@ -101,7 +101,7 @@ function resolveR2Prc20TokenSvm(params, targetChain, pushNetwork, hasSvmExecute)
     else if (hasSvmExecute) {
         const token = params.funds && params.funds.token;
         if (token) {
-            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
         }
         else {
             prc20Token = (0, helpers_1.getNativePRC20ForChain)(targetChain, pushNetwork);
@@ -1269,7 +1269,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                     if ((_a = params.funds) === null || _a === void 0 ? void 0 : _a.amount) {
                         const token = params.funds.token;
                         if (token) {
-                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                            prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                             burnAmount = params.funds.amount;
                         }
                     }
@@ -1321,7 +1321,7 @@ function buildPayloadForRoute(ctx, params, route, nonce) {
                 if ((_d = params.funds) === null || _d === void 0 ? void 0 : _d.amount) {
                     const token = params.funds.token;
                     if (token) {
-                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+                        prc20Token = push_chain_1.PushChain.utils.tokens.getPRC20Address(token).address;
                         burnAmount = params.funds.amount;
                     }
                 }

package/src/lib/orchestrator/payload-builders.js

@@ -68,7 +68,7 @@ function buildExecuteMulticall({ execute, ueaAddress, logger, }) {
                 functionName: 'transfer',
                 args: [execute.to, (_q = execute.funds) === null || _q === void 0 ? void 0 : _q.amount],
             });
-            const pushChainTo = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
+            const { address: pushChainTo } = push_chain_1.PushChain.utils.tokens.getPRC20Address(token);
             multicallData.push({
                 to: pushChainTo,
                 value: BigInt(0),

package/src/lib/utils.d.ts

@@ -256,21 +256,19 @@ export declare class Utils {
             }>;
         };
         /**
-         * Convert any supported origin-chain token into its mapped PRC20 token address on Push Chain.
+         * Convert any supported origin-chain token into its mapped PRC20 token on Push Chain.
          *
          * @param token - Either a MoveableToken from `pushChainClient.moveable.token.*`
          * or an object with the origin chain and token address.
-         * @returns {`0x${string}`} The synthetic asset address on Push Chain.
+         * @returns An object describing the synthetic PRC-20 on Push Chain.
          *
          * @example
          * ```jsx
-         * PushChain.utils.tokens.getPRC20Address(
-         *   token: MoveableToken | {
-         *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA;
-         *     address: `0x${string}`;
-         *   }
-         * );
-         * // → `0x...`
+         * const { address, chain, symbol, decimals, network } =
+         *   PushChain.utils.tokens.getPRC20Address({
+         *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA,
+         *     address: '0x...',
+         *   });
          * ```
          */
         getPRC20Address(token: MoveableToken | {
@@ -278,7 +276,13 @@ export declare class Utils {
             address: string;
         }, options?: {
             network?: PUSH_NETWORK;
-        }): `0x${string}`;
+        }): {
+            address: `0x${string}`;
+            chain: CHAIN;
+            symbol: string;
+            decimals: number;
+            network: PUSH_NETWORK;
+        };
     };
     /**
      * Internal: resolves a CHAIN enum from either a CHAIN value or a PushChain client instance.

package/src/lib/utils.js

@@ -601,42 +601,55 @@ Utils.tokens = {
         return { tokens };
     },
     /**
-     * Convert any supported origin-chain token into its mapped PRC20 token address on Push Chain.
+     * Convert any supported origin-chain token into its mapped PRC20 token on Push Chain.
      *
      * @param token - Either a MoveableToken from `pushChainClient.moveable.token.*`
      * or an object with the origin chain and token address.
-     * @returns {`0x${string}`} The synthetic asset address on Push Chain.
+     * @returns An object describing the synthetic PRC-20 on Push Chain.
      *
      * @example
      * ```jsx
-     * PushChain.utils.tokens.getPRC20Address(
-     *   token: MoveableToken | {
-     *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA;
-     *     address: `0x${string}`;
-     *   }
-     * );
-     * // → `0x...`
+     * const { address, chain, symbol, decimals, network } =
+     *   PushChain.utils.tokens.getPRC20Address({
+     *     chain: CONSTANTS.CHAIN.ETHEREUM_SEPOLIA,
+     *     address: '0x...',
+     *   });
      * ```
      */
     getPRC20Address(token, options) {
-        var _a, _b;
+        var _a, _b, _c, _d;
+        const network = (_a = options === null || options === void 0 ? void 0 : options.network) !== null && _a !== void 0 ? _a : enums_1.PUSH_NETWORK.TESTNET_DONUT;
+        const assertDeployed = (addr, ctx) => {
+            if (!addr || addr === '0xTBD') {
+                throw new Error(`PRC20 address not available for ${ctx} on network ${network}`);
+            }
+            return addr;
+        };
         // PushChainMoveableToken (pETH, pSOL, pUSDT(BNB), …) carries its PRC-20 address
-        // directly. Return it as-is — no registry lookup needed.
-        const maybePrc20 = token.prc20Address;
-        if (maybePrc20) {
-            return maybePrc20;
+        // and origin `sourceChain` directly — no registry lookup needed.
+        const pcToken = token;
+        if (pcToken.prc20Address) {
+            return {
+                address: assertDeployed(pcToken.prc20Address, `${(_b = pcToken.symbol) !== null && _b !== void 0 ? _b : 'token'} (${(_c = pcToken.sourceChain) !== null && _c !== void 0 ? _c : 'unknown'})`),
+                chain: pcToken.sourceChain,
+                symbol: pcToken.symbol,
+                decimals: pcToken.decimals,
+                network,
+            };
         }
-        // Infer origin chain and symbol by matching against the MOVEABLE_TOKENS registry
+        // Infer origin chain, symbol, decimals by matching against MOVEABLE_TOKENS
         let originChain;
         let tokenSymbol;
+        let tokenDecimals;
         if ('symbol' in token) {
             // MoveableToken path: infer chain by symbol + address
             for (const [key, list] of Object.entries(tokens_1.MOVEABLE_TOKENS)) {
                 const k = key;
-                const found = (list !== null && list !== void 0 ? list : []).some((t) => t.symbol === token.symbol && t.address === token.address);
-                if (found) {
+                const match = (list !== null && list !== void 0 ? list : []).find((t) => t.symbol === token.symbol && t.address === token.address);
+                if (match) {
                     originChain = k;
-                    tokenSymbol = token.symbol;
+                    tokenSymbol = match.symbol;
+                    tokenDecimals = match.decimals;
                     break;
                 }
             }
@@ -644,17 +657,20 @@ Utils.tokens = {
         else {
             // { chain, address } path: trust the provided chain and resolve symbol via registry
             originChain = token.chain;
-            const list = (_a = tokens_1.MOVEABLE_TOKENS[originChain]) !== null && _a !== void 0 ? _a : [];
-            const match = (list !== null && list !== void 0 ? list : []).find((t) => t.address === token.address);
+            const list = (_d = tokens_1.MOVEABLE_TOKENS[originChain]) !== null && _d !== void 0 ? _d : [];
+            const match = list.find((t) => t.address === token.address);
             if (match) {
                 tokenSymbol = match.symbol;
+                tokenDecimals = match.decimals;
             }
         }
-        if (!originChain || !tokenSymbol) {
+        if (!originChain || !tokenSymbol || tokenDecimals === undefined) {
             throw new Error('Unable to infer origin chain or token symbol for token');
         }
-        const network = (_b = options === null || options === void 0 ? void 0 : options.network) !== null && _b !== void 0 ? _b : enums_1.PUSH_NETWORK.TESTNET_DONUT;
         const map = chain_1.SYNTHETIC_PUSH_ERC20[network];
+        if (!map) {
+            throw new Error(`No PRC20 address map configured for network: ${network}`);
+        }
         // Map token → synthetic key by origin chain family
         const isEthFamily = originChain === enums_1.CHAIN.ETHEREUM_MAINNET ||
             originChain === enums_1.CHAIN.ETHEREUM_SEPOLIA;
@@ -716,7 +732,13 @@ Utils.tokens = {
             default:
                 throw new Error(`Unsupported token symbol: ${tokenSymbol}`);
         }
-        return map[key];
+        return {
+            address: assertDeployed(map[key], `${tokenSymbol} on ${originChain}`),
+            chain: originChain,
+            symbol: tokenSymbol,
+            decimals: tokenDecimals,
+            network,
+        };
     },
 };
 //# sourceMappingURL=utils.js.map