@pushchain/core 6.0.20 → 6.0.22

package/CHANGELOG.md

@@ -1,3 +1,70 @@
+@pushchain/core@6.0.22 (2026-08-14)
+
+- fix: make PC20 first exports and Solana R3 E2E reliable
+- fix: support PC20 exports for standard ERC-20 tokens
+- feat: curated E2E CI suite with pre-flight fund gate
+
+---
+
+@pushchain/core@6.0.21 (2026-08-01)
+
+- fix: pc20 bug fix
+- fix: bug fixes
+- fix: pc20 e2es and bug fixes
+- feat: pc20 fixes
+- fix: pc20 plan
+
+---
+
+@pushchain/core@6.1.0 (unreleased)
+
+- Added first-class PC20 support to the universal transaction API. PC20 tokens
+  are identified by chain and address without an explicit token-standard flag.
+  External wrappers are resolved through UniversalCore, while Push-native
+  tokens are validated directly on Push Chain.
+
+- Removed the custom `pc20Metadata()` requirement for Push-native PC20 exports.
+  Any metadata-compatible ERC-20 born on Push Chain can now be exported: the SDK
+  reads the standard `name()`, `symbol()`, and `decimals()` functions, verifies
+  deployed bytecode, and continues to reject synthetic PRC20 addresses from the
+  PC20 path.
+
+- Added `PushChain.utils.tokens.getPC20Address()` for resolving either a
+  Push-native PC20 or an external wrapper and listing its confirmed deployments.
+  Spending paths also validate registry identity and reject wrong-chain,
+  ambiguous, stale, or unregistered token references before approval or
+  broadcast.
+
+- Added PC20 execution across EVM and Solana for Route 1 (external wrapper burn
+  to Push), Route 2 (Push token export), and Route 3 (CEA-held wrapper return).
+  This includes first-export wrapper prediction, Solana ATA delivery and
+  fallback behavior, PC20 gas quoting, and typed PC20 errors. Route 4 remains
+  unsupported for PC20.
+
+- Fixed funds-only PC20 returns and cascades producing a selector-only
+  `0x50433230` payload. The SDK now preserves PC20 routing metadata, builds a
+  complete universal forwarding payload on EVM and Solana, revalidates prepared
+  sends against the live registry, and fails closed when no safe payload can be
+  constructed.
+
+- Fixed PC20 return tracking when a gateway transaction emits both a wrapper
+  burn event and a native gas-credit event. Tracking now follows the PC20 burn
+  leg by payload selector instead of relying on event position.
+
+- Fixed prepaid native gas credit on PC20 burns by using the sender's executor
+  account as the gateway recipient instead of the zero address, preventing the
+  forwarded funds leg from attempting to credit `address(0)`.
+
+- Fixed first PC20 wrapper deployments running out of gas on the destination.
+  The SDK now re-quotes UGPC with the resolved deployment-aware limit and writes
+  the corresponding explicit limit into the outbound request.
+
+- Realigned inbound protobuf fields with the chain, exposed PC20 inbound
+  metadata, and added SVM remaining-account support required by the Solana
+  gateway.
+
+---
+
 @pushchain/core@6.0.20 (2026-07-10)
 
 - fix: support custom EIP-7702 signers and dynamic multicall gas

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushchain/core",
-  "version": "6.0.20",
+  "version": "6.0.22",
   "homepage": "https://push.org",
   "keywords": [
     "pushchain",
@@ -50,7 +50,11 @@
     }
   },
   "scripts": {
-    "build:proto": "scripts/protoc-generate.sh"
+    "build:proto": "scripts/protoc-generate.sh",
+    "e2e:list": "ts-node --transpile-only __e2e__/ci/run.ts --list",
+    "e2e:verify": "ts-node --transpile-only __e2e__/ci/run.ts --verify",
+    "e2e:preflight": "ts-node --transpile-only __e2e__/ci/preflight.ts",
+    "e2e:ci": "ts-node --transpile-only __e2e__/ci/run.ts"
   },
   "type": "commonjs",
   "main": "./src/index.js",
@@ -67,7 +71,9 @@
   ],
   "devDependencies": {
     "@types/bs58": "^4.0.0",
+    "dotenv": "^16.4.5",
     "secp256k1": "^5.0.1",
+    "ts-node": "10.9.1",
     "ts-proto": "^2.0.3"
   }
 }

package/src/lib/cache/cache.js

@@ -11,6 +11,8 @@ class CacheKeys {
 }
 exports.CacheKeys = CacheKeys;
 class Cache {
+    cache;
+    maxSize;
     constructor(maxSize = 100) {
         this.cache = new Map();
         this.maxSize = maxSize;

package/src/lib/constants/abi/erc20.evm.d.ts

@@ -1,4 +1,34 @@
 export declare const ERC20_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
     readonly type: "function";
     readonly name: "balanceOf";
     readonly inputs: readonly [{

package/src/lib/constants/abi/erc20.evm.js

@@ -2,6 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ERC20_EVM = void 0;
 exports.ERC20_EVM = [
+    {
+        type: 'function',
+        name: 'name',
+        inputs: [],
+        outputs: [{ name: '', type: 'string', internalType: 'string' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'symbol',
+        inputs: [],
+        outputs: [{ name: '', type: 'string', internalType: 'string' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'decimals',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint8', internalType: 'uint8' }],
+        stateMutability: 'view',
+    },
     {
         type: 'function',
         name: 'balanceOf',

package/src/lib/constants/abi/index.d.ts

@@ -12,5 +12,6 @@ export { CEA_FACTORY_EVM } from './ceaFactory.evm';
 export { UNIVERSAL_GATEWAY_PC } from './universalGatewayPC.evm';
 export { UNIVERSAL_CORE_EVM } from './prc20.evm';
 export { UEA_FACTORY_ABI } from './uea-factory';
+export { PC20_FACTORY_EVM, PC20_WRAPPER_EVM, EXTERNAL_GATEWAY_PC20_EVM, VAULT_PC20_FACTORY_EVM, } from './pc20.evm';
 export { WPC_EVM } from './wpc.evm';
 export { UNIV3_SWAP_ROUTER_EVM } from './uniswap-v3-router.evm';

package/src/lib/constants/abi/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNIV3_SWAP_ROUTER_EVM = exports.WPC_EVM = exports.UEA_FACTORY_ABI = exports.UNIVERSAL_CORE_EVM = exports.UNIVERSAL_GATEWAY_PC = exports.CEA_FACTORY_EVM = exports.CEA_EVM = exports.SVM_GATEWAY_IDL = exports.ERC20_EVM = exports.UNIVERSAL_GATEWAY_V1_SEND = exports.UNIVERSAL_GATEWAY_V0 = exports.UEA_SVM = exports.UEA_EVM = exports.FACTORY_V1 = exports.FEE_LOCKER_SVM = exports.FEE_LOCKER_EVM = void 0;
+exports.UNIV3_SWAP_ROUTER_EVM = exports.WPC_EVM = exports.VAULT_PC20_FACTORY_EVM = exports.EXTERNAL_GATEWAY_PC20_EVM = exports.PC20_WRAPPER_EVM = exports.PC20_FACTORY_EVM = exports.UEA_FACTORY_ABI = exports.UNIVERSAL_CORE_EVM = exports.UNIVERSAL_GATEWAY_PC = exports.CEA_FACTORY_EVM = exports.CEA_EVM = exports.SVM_GATEWAY_IDL = exports.ERC20_EVM = exports.UNIVERSAL_GATEWAY_V1_SEND = exports.UNIVERSAL_GATEWAY_V0 = exports.UEA_SVM = exports.UEA_EVM = exports.FACTORY_V1 = exports.FEE_LOCKER_SVM = exports.FEE_LOCKER_EVM = void 0;
 const tslib_1 = require("tslib");
 var feeLocker_evm_1 = require("./feeLocker.evm");
 Object.defineProperty(exports, "FEE_LOCKER_EVM", { enumerable: true, get: function () { return feeLocker_evm_1.FEE_LOCKER_EVM; } });
@@ -31,6 +31,12 @@ var prc20_evm_1 = require("./prc20.evm");
 Object.defineProperty(exports, "UNIVERSAL_CORE_EVM", { enumerable: true, get: function () { return prc20_evm_1.UNIVERSAL_CORE_EVM; } });
 var uea_factory_1 = require("./uea-factory");
 Object.defineProperty(exports, "UEA_FACTORY_ABI", { enumerable: true, get: function () { return uea_factory_1.UEA_FACTORY_ABI; } });
+// PC20
+var pc20_evm_1 = require("./pc20.evm");
+Object.defineProperty(exports, "PC20_FACTORY_EVM", { enumerable: true, get: function () { return pc20_evm_1.PC20_FACTORY_EVM; } });
+Object.defineProperty(exports, "PC20_WRAPPER_EVM", { enumerable: true, get: function () { return pc20_evm_1.PC20_WRAPPER_EVM; } });
+Object.defineProperty(exports, "EXTERNAL_GATEWAY_PC20_EVM", { enumerable: true, get: function () { return pc20_evm_1.EXTERNAL_GATEWAY_PC20_EVM; } });
+Object.defineProperty(exports, "VAULT_PC20_FACTORY_EVM", { enumerable: true, get: function () { return pc20_evm_1.VAULT_PC20_FACTORY_EVM; } });
 // SDK 5.2 gas abstraction (Case C overflow bridging)
 var wpc_evm_1 = require("./wpc.evm");
 Object.defineProperty(exports, "WPC_EVM", { enumerable: true, get: function () { return wpc_evm_1.WPC_EVM; } });

package/src/lib/constants/abi/pc20.evm.d.ts

@@ -0,0 +1,192 @@
+/**
+ * PC20 ABIs — minimal read surfaces for registry resolution and validation.
+ *
+ * Sources:
+ *   PC20Factory      push-chain-gateway-contracts/contracts/evm-gateway/src/PC20Factory.sol
+ *   PC20Wrapper      push-chain-gateway-contracts/contracts/evm-gateway/src/PC20Wrapper.sol
+ *   UniversalGateway push-chain-gateway-contracts/contracts/evm-gateway/src/UniversalGateway.sol
+ *
+ * Read-only entries only. Writes go through the existing gateway ABIs — PC20
+ * changes the payload, not the entrypoint.
+ */
+/**
+ * Destination-chain factory.
+ *
+ * `computeWrapperAddress` is deliberately called on-chain rather than
+ * reimplementing CREATE2 in the SDK: the factory derives the address from its
+ * own `type(PC20Wrapper).creationCode`, so calling the live registered factory
+ * cannot desynchronize from the deployed wrapper bytecode the way a mirrored
+ * init-code hash would.
+ */
+export declare const PC20_FACTORY_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "getWrapper";
+    readonly inputs: readonly [{
+        readonly name: "sourceAsset";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "wrapper";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "wrapperToSource";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "sourceToWrapper";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isPC20Wrapper";
+    readonly inputs: readonly [{
+        readonly name: "addr";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "computeWrapperAddress";
+    readonly inputs: readonly [{
+        readonly name: "sourceAsset";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "predicted";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_NAME_LENGTH";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_SYMBOL_LENGTH";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "error";
+    readonly name: "EmptyName";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NameTooLong";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "EmptySymbol";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SymbolTooLong";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}];
+/** Deployed wrapper on an external chain. `SOURCE_ASSET` is immutable. */
+export declare const PC20_WRAPPER_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "SOURCE_ASSET";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "factory";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+/**
+ * Destination Vault's configured factory.
+ *
+ * The Vault — not the gateway — is what calls `deployWrapper` at settlement
+ * (`Vault.sol:327`), so this is the authoritative answer to where a
+ * not-yet-deployed wrapper will land. Both pointers exist independently and are
+ * set separately; they happen to agree on all four testnets today, but only
+ * this one governs deployment.
+ */
+export declare const VAULT_PC20_FACTORY_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "pc20Factory";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IPC20Factory";
+    }];
+    readonly stateMutability: "view";
+}];
+/**
+ * External gateway's configured factory.
+ *
+ * Compared against the reference factory (the destination Vault's
+ * `pc20Factory()`, or `UniversalCore.pc20FactoryByChain` if a future upgrade
+ * exposes it) — if they disagree the live gateway will not take the PC20 burn
+ * path for this token.
+ */
+export declare const EXTERNAL_GATEWAY_PC20_EVM: readonly [{
+    readonly type: "function";
+    readonly name: "pc20Factory";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract IPC20Factory";
+    }];
+    readonly stateMutability: "view";
+}];

package/src/lib/constants/abi/pc20.evm.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * PC20 ABIs — minimal read surfaces for registry resolution and validation.
+ *
+ * Sources:
+ *   PC20Factory      push-chain-gateway-contracts/contracts/evm-gateway/src/PC20Factory.sol
+ *   PC20Wrapper      push-chain-gateway-contracts/contracts/evm-gateway/src/PC20Wrapper.sol
+ *   UniversalGateway push-chain-gateway-contracts/contracts/evm-gateway/src/UniversalGateway.sol
+ *
+ * Read-only entries only. Writes go through the existing gateway ABIs — PC20
+ * changes the payload, not the entrypoint.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXTERNAL_GATEWAY_PC20_EVM = exports.VAULT_PC20_FACTORY_EVM = exports.PC20_WRAPPER_EVM = exports.PC20_FACTORY_EVM = void 0;
+/**
+ * Destination-chain factory.
+ *
+ * `computeWrapperAddress` is deliberately called on-chain rather than
+ * reimplementing CREATE2 in the SDK: the factory derives the address from its
+ * own `type(PC20Wrapper).creationCode`, so calling the live registered factory
+ * cannot desynchronize from the deployed wrapper bytecode the way a mirrored
+ * init-code hash would.
+ */
+exports.PC20_FACTORY_EVM = [
+    {
+        type: 'function',
+        name: 'getWrapper',
+        inputs: [{ name: 'sourceAsset', type: 'address', internalType: 'address' }],
+        outputs: [{ name: 'wrapper', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'wrapperToSource',
+        inputs: [{ name: '', type: 'address', internalType: 'address' }],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'sourceToWrapper',
+        inputs: [{ name: '', type: 'address', internalType: 'address' }],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'isPC20Wrapper',
+        inputs: [{ name: 'addr', type: 'address', internalType: 'address' }],
+        outputs: [{ name: '', type: 'bool', internalType: 'bool' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'computeWrapperAddress',
+        inputs: [{ name: 'sourceAsset', type: 'address', internalType: 'address' }],
+        outputs: [{ name: 'predicted', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    // Name/symbol byte limits enforced at deployWrapper. Read so the SDK can fail
+    // fast on the Push side instead of reverting on the destination chain.
+    {
+        type: 'function',
+        name: 'MAX_NAME_LENGTH',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256', internalType: 'uint256' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'MAX_SYMBOL_LENGTH',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256', internalType: 'uint256' }],
+        stateMutability: 'view',
+    },
+    { type: 'error', name: 'EmptyName', inputs: [] },
+    { type: 'error', name: 'NameTooLong', inputs: [] },
+    { type: 'error', name: 'EmptySymbol', inputs: [] },
+    { type: 'error', name: 'SymbolTooLong', inputs: [] },
+    { type: 'error', name: 'ZeroAddress', inputs: [] },
+];
+/** Deployed wrapper on an external chain. `SOURCE_ASSET` is immutable. */
+exports.PC20_WRAPPER_EVM = [
+    {
+        type: 'function',
+        name: 'SOURCE_ASSET',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'factory',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+];
+/**
+ * Destination Vault's configured factory.
+ *
+ * The Vault — not the gateway — is what calls `deployWrapper` at settlement
+ * (`Vault.sol:327`), so this is the authoritative answer to where a
+ * not-yet-deployed wrapper will land. Both pointers exist independently and are
+ * set separately; they happen to agree on all four testnets today, but only
+ * this one governs deployment.
+ */
+exports.VAULT_PC20_FACTORY_EVM = [
+    {
+        type: 'function',
+        name: 'pc20Factory',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'contract IPC20Factory' }],
+        stateMutability: 'view',
+    },
+];
+/**
+ * External gateway's configured factory.
+ *
+ * Compared against the reference factory (the destination Vault's
+ * `pc20Factory()`, or `UniversalCore.pc20FactoryByChain` if a future upgrade
+ * exposes it) — if they disagree the live gateway will not take the PC20 burn
+ * path for this token.
+ */
+exports.EXTERNAL_GATEWAY_PC20_EVM = [
+    {
+        type: 'function',
+        name: 'pc20Factory',
+        inputs: [],
+        outputs: [{ name: '', type: 'address', internalType: 'contract IPC20Factory' }],
+        stateMutability: 'view',
+    },
+];
+//# sourceMappingURL=pc20.evm.js.map